POPUPMENU

PLBCMP GUI Only

The POPUPMENU instruction defines an object variable for a standard GUI pop-up menu. To define a POPUPMENU, use one of the following statement formats:

(1)	[label]	POPUPMENU	[%]
(2)	[label]	POPUPMENU	(arraysize)
(3)	[label]	POPUPMENU	^
(4)	[label]	POPUPMENU	^,{target}
(5)	[label]	POPUPMENU	^(arraysize)
(6)	[label]	POPUPMENU	^(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:

POPUPMENU is an obsolete object replaced by the COMBOBOX object.
A POPUPMENU contains as many items as there are lines in the menu. Each menu line is one item.
The entire POPUPMENU is referenced as item number zero.
Items are accessible through the SETITEM or GETITEM instructions.
Multi-dimension arrays are supported to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a POPUPMENU may be defined as Global, it is DESTROYed during a CHAIN instruction.
The CHECKITEM instruction allows a check mark to appear with a menu item.
POPUPMENUs cannot be scaled using the WINDOW Scale method.