CREATE COMBOBOX

PLBCMP GUI Only

The CREATE COMBOBOX statement initializes a COMBOBOX object variable. The statement format is:

Where:

label

Optional. A Program Execution Label.

parent

Optional. A previously created WINDOW or PANEL object variable or pointer to a WINDOW or PANEL object on which the object is created.

combobox

Required. The name of a previously defined COMBOBOX object variable or pointer to a COMBOBOX object.

pos

Required. The screen position of the object given as: {top}:{bottom}:{left}:{right}.

name

Required. A Character String Variable or Literal defining a title for the COMBOBOX.

menu

Required. A Character String Variable, character Literal, Numeric Variable, or decimal constant defining special menu functions as described below.

property list

Optional. One or more of the object properties.

Flags Affected: NONE

Note the following:

1. The {pos} screen coordinates for the object must be given and must be valid. Each of the coordinates may be a numeric variable, an Expression, or a decimal constant.

2. The {name} operand provides a title for the menu.

3. If {menu} is specified by a character string contained in a character variable or character literal, special characters are allowed that help define the menu. However, when using a PL/B Web server runtime, all {menu} special characters are removed and ignored without being displayed.

4. The special character control characters '(', ')', '/', and '<' can be included as part of an item name by repeating the character in the {menu-data} string.

5. The first item in the {menu} character string is not used for the COMBOBOX.

6. To allow for dynamic usage of fonts without changing object coordinates, the top and bottom size of the combo box window are determined by the initial number of items in {menu}. If the program adds more items to the COMBOBOX using the INSERTITEM instruction, the initial size does not change. However, scroll bars become visible to access other items for the COMBOBOX.

7. The height of the COMBOBOX is determined by the font size.

8. If the optional {parent} parameter is not specified, the default window is used.

9. The SETMODE *SUBTABFORENTER control alters the ENTER key behavior of a COMBOXBOX.

See Also: Example Code, CREATE, Object Output Instructions