hilitedButtonName

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the hilitedButtonName of <group> to <buttonName>
Associationsgroup
Summary

Specifies which button in a group is currently highlighted.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
set the hilitedButtonName of group "Options" to "Help"
Values
NameTypeDescription
Value

The hilitedButtonName of a group is the short name property of a button.

RelatedKeyword: button
Property: family, hilite, hilitedButtonID, name, hilitedButton, autoHilite, radioBehavior
Command: hilite, group
Object: button
Glossary: property, highlight, radio button
Description

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

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

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|radio-button clusters. In a radio-button cluster, only one button can be highlighted 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|radio-button cluster.

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

Tagsui