RemoveItem Method (FLOATMENU, MENU, SUBMENU)

9.0, PLBCMP GUI Only

The RemoveItem method deletes a MENUITEM from a FLOATMENU, MENU, or SUBMENU. The method uses the following format:

[label]	{object}.RemoveItem	[GIVING {return}]:
		USING [Key=]{key*}]:

Where:

label

Optional. A Program Execution Label.

object

Required. A FLOATMENU, MENU or SUBMENU object from which an item is removed.

return

Optional. A Numeric Variable that indicates the success or failure of the method.

key

Required. A Character String Variable that specifies the run-time name (RUNNAME property) or a Numeric Variable that specifies the zero-based position of the menu item that is removed.

Flags Affected: EOS, OVER, ZERO

Note the following:

If the value returned is zero, the ZERO Condition Flag is set.
The OVER and EOS Condition Flags are always cleared.
A return value of zero (0) indicates success.
For improved performance in the Application Server environment, do not specify the optional return value unless needed.