hilitedButtonName

Specifies which button in a group is currently highlight.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the hilitedButtonName of group to buttonName

# Examples

set the hilitedButtonName of group "Options" to "Help"

# Description

Use the hilitedButtonName property to change the current setting in a radio button.

The hilitedButtonName specifies which button in a group is currently highlight. If the hilitedButtonName of a group is empty, none of the buttons in the group is currently highlight.

Setting the hilitedButtonName of a group sets the hilite property of the rest of the buttons to false.

The hilitedButtonName property is most useful in radio button. In a radio button, only one button can be highlight at once: clicking another button unhighlights the first one. The radioBehavior property of a group of buttons specifies whether they act as a radio button.

The hilitedButton, hilitedButtonName, and hilitedButtonID property all refer in different ways to the same button. When any of them changes, all of them change.

# Tags

ui,

# See

- **keyword:** button - **property:** family, hilite, hilitedButtonID, name, hilitedButton, autoHilite, radioBehavior - **command:** hilite, group - **object:** button - **glossary:** property, highlight, radio button