Action Statement
Change the displayed text or value of a dialog box, dialog control, title bar, or item.
For Dialog Boxes, Dialog Controls, and Regions' Title Bars:
change OBJECT_NAME [text|value] to TEXT_STRING
For Items:
change item {ITEM_NAME [from AB_NAME]|ITEM_CLASS_NAME}
in {REGION_NAME|REG_CLASS_NAME} [text|value] to ITEM_TEXT
OBJECT_NAME
The identifier for a dialog box, a dialog control containing text or values (except, in ESL for Windows only, for drop-down list boxes and drop-down combination boxes), or a dialog region containing a title bar.
TEXT_STRING
A string value representing the new text or new value to be displayed in the object or title bar.
ITEM_NAME
The identifier for a pulldown, button, or choice.
AB_NAME
The identifier for an action bar template. You must specify the action bar name if more than one template contains an item of the given name. It cannot be specified if the item was defined outside of an action bar template.
ITEM_CLASS_NAME
The identifier for an item class.
REGION_NAME
The identifier for a region containing the item.
REG_CLASS_NAME
The identifier for a class of regions.
ITEM_TEXT
A string value representing the new text to be displayed in the item. This text can be any string.
Description
Use this statement to change the displayed text or current value of a dialog box, dialog control, title bar, or item.
If you specify protected characters in a character mask for use with validation, be sure to include these characters when you use this statement to change the text of an entry field. For example, if you have defined a mask for a social security number as "DDD-DD-DDDD" and you want to initialize the value of that field, the TEXT_STRING might be "123-45-6789", not just "123456789". In addition, when you copy the text of ENTRY_FIELD, the value returned will include any protected characters. Therefore, if you evaluated this field before entering any data, it would return the value " - - ".
Example
response to Report_Names_TR
copy textual line ycoord from Report_Names_TR to Window_Title_SV
change View_Window_GR text to Window_Title
response to ListOfFiles_CL
copy parameter of object to NewFileTitle_SV
change Report_TR text to NewFileTitle_SV
# The text in the title bar will be changed.
See Also
action bar Attribute Definition
button, choice, pulldown, separator Definitions
check box, combination box, dropdown list, group box, push button,
radio button, spin button, static text Definitions
dialog box Definition
dialog region, graphical region, image region, textual region Definitions
