TOOLBUTTON


PLBCMP GUI Only

square.png Properties

square.png Methods

square.png Instructions

 

The TOOLBUTTON defines a button for a TOOLBAR object. To define a TOOLBUTTON, use one of the following statement formats:

 

(1)

[label]

TOOLBUTTON

[%]

(2)

[label]

TOOLBUTTON

(arraysize)

(3)

[label]

TOOLBUTTON

^

(4)

[label]

TOOLBUTTON

^,{label}

(5)

[label]

TOOLBUTTON

^(arraysize)

(6)

[label]

TOOLBUTTON

^(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:

  1. 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.

  2. 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.

  3. Multi-dimension arrays are supported up to a maximum of fourteen dimensions.

  4. The ^ denotes Pointer Variable.

  5. TOOLBUTTON objects may not be added to a COLLECTION.

  6. Although a TOOLBUTTON may be defined as Global, it is DESTROYed during a CHAIN instruction.

  7. 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

 



PL/B Language Reference TOOLBAR TREEVIEW