label

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the label of <object> to <labelString>
Synonymstitle
Associationsstack, button, graphic
Summary

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.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
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
Values
NameTypeDescription
Value

The label of an object is a string. By default, the label property of newly created buttons, graphics, groups, and stacks is set to empty.

RelatedKeyword: string, effective
Property: name, showName, longWindowTitles, unicodeTitle, acceleratorText, menuHistory, titleWidth
Command: constant
Function: stacks
Glossary: object, property, title bar, message, stack window, group, expression
Object: graphic, button
Description

Use the label property as a user-visible replacement for an ungainly name, or to change the visible name of a window or object 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.

Note: Card numbers will not be displayed in the title bar of a stack if its label property is not empty.

Tagsui