Purpose

.Label allows you to specify the label that is applied to certain objects.
 

Syntax

Setting:          ObjectReference.Label = Value

Retrieving:     Variable = ObjectReference.Label
 

Operation

ObjectReference is the Tag Name of the object
Value is a character string
Variable is an alphanumeric variable
 

Remarks

Label cannot be set to an empty string or a blank string for radio labels.

The property can only be used for a Static Text object if the .Textbox property has already been set in the development environment.

The retrieving command will cause the variable to contain the value in the same format it was specified.
 

Example

To set the label for a format box label (Tag Name = CUSTOMERNAMEBOXLABEL):

CUSTOMERNAMEBOXLABEL.Label = "Top 25 Customers"


To set the label for the radio group box (Tag Name = CREDITCARDGROUP):

CREDITCARDGROUP.Label = "Select a Card"


To set the label for the VISAICON graphic, using an alpha variable:

$VISAICONLABEL = "The New Visa"
VISAICON.Label = $VISAICONLABEL


To set the label for the VisaButton radio within the CreditCardGroup radio group:

CreditCardGroup.Button("VisaButton").Label = "BofA Visa"


To retrieve the label text from the VisaButton radio  within the CreditCardGroup radio group:

$VISABUTTON_LABEL = CreditCardGroup.Button("VisaButton").LABEL


To retrieve the label text from the icon graphic (Tag Name = VISAICON):

$VISAICON_LABEL = VISAICON.Label