COMBOBOX

PLBCMP GUI Only

The COMBOBOX instruction defines an object variable for a standard GUI combination box. A COMBOBOX combines an EDITTEXT object with a DATALIST object. Users can select an item from the list or type directly into the edit box. To define a COMBOBOX, use one of the following statement formats:

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

The COMBOBOX object replaces the obsolete POPUPMENU.
A COMBOBOX contains as many items as there are lines in the menu. Each menu line is one item.
The entire COMBOBOX is referenced as item number zero.
User selection of an item in a COMBOXBOX generates a CLICK event.
Items are accessible through the SETITEM or GETITEM instructions.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable.
Although a COMBOBOX may be defined as Global, it is DESTROYed during a CHAIN instruction.
The SETMODE *SUBTABFORENTER control alters the ENTER key behavior of a COMBOXBOX.