text

Topic group Related topics Example

The non-editable text that appears in a component.

Property of

Browse, CheckBox, Form, Menu, PushButton, RadioButton, Rectangle, SubForm, Text, TextLabel, ToolBar,TreeItem

Description

The text of a CheckBox or RadioButton object is the descriptive text that appears beside the actual check box or RadioButton. The text of a TreeItem object is the item’s editable text label. The text of a PushButton object is the text that appears on the button face, and the text of a Menu object is the menu prompt.

The text of a Rectangle object is the caption text that appears at the top of the control. The text of a Form object is the text that appears in the form’s title bar. The text of a floating ToolBar is the text that appears in it's title bar. The text property has no effect in a Browse object; the property exists for compatibility only.

The text of a Text or TextLabel object is the content of the object. For a Text object, this is the actual HTML text that is displayed in the form or report.

You may assign any of the following types of data to the text property of a Text component:

Boolean

Numeric

Integer

Character

Object

Null

DateTime

Codeblock

If you assign a codeblock to the text property, it must return a value. Use either an expression codeblock or a statement codeblock that uses RETURN to return a value. The codeblock is evaluated whenever it is rendered.

Creating Accelerator Keys

Use a pick character to create an accelerator key to let the user select a menu item or simulate clicking a CheckBox, RadioButton, or PushButton by pressing Alt and the pick character. To designate a character as a pick character, precede it with an ampersand (&) in the object’s text property. The pick character is underlined when the object is displayed. A pick character may also be used for the text of a Text, TextLabel or Rectangle object; pressing the key combination gives focus to the first control that follows the object in the z-order that can receive focus.

Note

When a PushButton's speedBar property is set to "true", accelerator keys are ignored.