Livecode Wiki

Specifies the string shown in a stack window's title bar, or a text label to be displayed on the specified object if its showName property is true.


set the label to <object> to <lableString>


set the label of button 1 to "Hello" & return & "World"
get the label of button "Choices Popup" -- current menu choice
set the label of this stack to the short name of this card

Use the label property as a user-visible replacement for an ungainly name, or to change the visible name of a window or object(glossary) when changing the actual name would require changing code that refers to it.

If a button's menuMode is either "option" or "comboBox", the button's label is the text of the currently selected menu option. Setting the label property changes the currently selected option. (To change the currently selected option while sending the appropriate message, set the button's menuHistory instead.)

To create a multiple-line label for a button or graphic, place a return constant in the label.

If an object's label is empty, the object's name property is displayed instead. In this case, the expression the effective label of button reports the button's name property.

To create a blank title bar, set the stack's label property to a space.

See also: graphic, button, name, showName, longWindowTitles, unicodeTitle, acceleratorText, menuHistory & titleWidth.