TOOLBUTTON
PLBCMP GUI Only
The TOOLBUTTON defines a button for a TOOLBAR object. To define a TOOLBUTTON, use one of the following statement formats:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
The TOOLBAR object is composed of multiple TOOLBUTTON objects that can be added and removed using methods. Each tool button can be accessed directly via a BUTTONS collection or retrieved into a TOOLBUTTON object that is manipulated.
TOOLBUTTONs may not be used in a CREATE statement. The object can be initialized or created using the AddButton method of the TOOLBAR object. Once this new object is initialized or created, normal GETPROP, SETPROP, and DESTROY instructions can be used for the object.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
TOOLBUTTON objects may not be added to a COLLECTION.
Although a TOOLBUTTON may be defined as Global, it is DESTROYed during a CHAIN instruction.
If the CAUSEVALID property for a TOOLBUTTON is enabled, the CAUSEVALID property for its parent TOOLBAR must also be enabled before a VALIDATE event can be triggered by the toolbutton
See Also: Example Code, Object Definitions, Object Output Instructions
![]() |