TEXT action attribute

The TEXT attribute defines the label associated to the action.

Syntax 1 (Dialog action handlers and form action defaults):

TEXT = [%]"string"
  1. string defines the label for the action, with the % prefix for a localized string.

Syntax 2 (Global .4ad action defaults file):

text = "string"
  1. string is the text to display. Use <LStr/> child element for a localized string.

Usage

The TEXT attribute is used to define the label associated to an action, for example for a CHECKBOX form field or a BUTTON action view.

Consider using localized strings with the %"string-id" syntax, if you plan to internationalize your application.

This action attribute can be specified as action default attribute in a global .4ad file, in the ACTION DEFAULTS section of form files, as dialog action attribute, or as action view attribute.

Example

-- As action handler attribute
ON ACTION print ATTRIBUTES(TEXT="Print")

-- As form action default
ACTION DEFAULTS
  ACTION print (TEXT="Print")
END

-- As a CHECKBOX label
CHECKBOX cb01 = FORMONLY.checkbox01, 
                TEXT="OK" ... ;

-- As a BUTTON label, using a localized string id
BUTTON b1: print, TEXT=%"actions.print.label";

-- In a global action defaults file with a localized string id
<ActionDefault name="zoom" text="Zoom" ... >
   <LStr text="actions.zoom.label" />
</ActionDefault>