STATTEXT

PLBCMP GUI Only

The STATTEXT instruction defines an object variable for a standard static text item. The text can label another control and can set focus to that control when the user types an accelerator key. To define a STATTEXT, use one of the following statement formats:

(1)	[label ]	STATTEXT	[% ]
(2)	[label ]	STATTEXT	(arraysize )
(3)	[label ]	STATTEXT	^
(4)	[label ]	STATTEXT	^ ,{target }
(5)	[label ]	STATTEXT	^(arraysize)
(6)	[label ]	STATTEXT	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

A STATTEXT contains only one item that is the text information.
The STATTEXT is always referenced as item number zero.
Items are accessible through the SETITEM or GETITEM instructions.
This object contains a line of text displayed using a specific font.
The STATTEXT object supports FONT objects that use the ANGLE property. When a FONT object with the ANGLE property is specified, the text output occurs at the angle defined.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a STATTEXT may be defined as Global, it is DESTROYed during a CHAIN instruction.
When a single '&' character is to appear in a STATTEXT using the PL/B Web Server, the data string must use the two character sequence of '&&' in the output string. The '&&' usage forces a single '&' output similar to a Windows control.