TEXT action attribute
The TEXT
attribute defines the label associated to the
action.
Syntax 1 (Dialog action handlers and form action defaults):
TEXT = [
%]
"string"
- string defines the label for the action, with the % prefix for a localized string.
Syntax 2 (Global .4ad action defaults file):
text = "string"
- 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 (using ON ACTION name
ATTRIBUTES(...)
), or directly as action view attribute (in the form definition file).Note: Action view decoration attributes such as
TEXT
,
IMAGE
and COMMENT
defined at dialog level with ON ACTION
name ATTRIBUTES(...)
apply only to default action views. See Dialog action handler attributes for more details.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>