CREATE SUBMENU

PLBCMP GUI Only

The CREATE SUBMENU statement initializes a SUBMENU 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.

submenu

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

menu-data

Required. A Character String Variable, a character Literal, a Numeric Variable, an Expression, or a decimal constant.

menu

Required. The name of the parent MENU object variable or SUBMENU object variable.

item-no

Required. A Numeric Variable, an Expression, or a decimal constant referring to the item number of the parent menu.

Flags Affected: NONE

Note the following:

1. The resource number of the menu, a character variable, or a character literal must be given to describe the {menu} object.

2. The {menu} operand must have been previously created and the {item-no} given must indicate an existing menu item.

3. Menu items within the {menu-data} are semicolon delimited.

4. If {menu-data} is specified by a character variable or character literal, special characters are allowed that help define the menu.

5. {menu-data} items may have special suffixes that result in one of the standard Edit menu functions being activated when the item is selected. The runtime also automatically enables or disables these items based on the current focus and the status of the clipboard.

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

7. The first item in the {menu-data} character string is not used for SUBMENU.

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

See Also: Example Code, CREATE, Object Output Instructions