MENU CLEAR

Resets menu item values to their defaults.

Syntax

MENU CLEAR object

Parameters

object

Can be
menu
The name of a currently open menu, all of whose items are to be cleared.
menuitem
The name of a particular menu item to be cleared.
([exp1 ],[exp2 ],[exp3 ])
Positive integers or expressions that evaluate to positive integers, that identify a particular menu or menu item. Exp1 identifies the menu number; exp2, the item number. (Exp3 is reserved for future use.) Exp1, exp2, and exp3 must be positive integers or expressions that evaluate to positive integers. At least one of exp1 or exp2 must be specified.

Comments

MENU CLEAR resets each of the specified items within the open menu in the current window to their default values, as specified when the objects were defined in the Object Dictionary. The menu or menu items do not change in appearance until redisplayed using a MENU DISPLAY command.

If an item in the menu is currently in an invalid state owing to application user input, the MENU CLEAR command that applies to that item clears the invalid state.

Note that when a menu is opened (by a MENU OPEN command), all menu items are set to their default values.

Example

To reset all items in Menu1 to their default values, enter

menu clear Menu1

 

Related Topics