SYNTAX

DeleteMenu [(menuName | -help) [itemName]]

DESCRIPTION

The DeleteMenu command deletes the specified user-defined menus or menu items. You can delete a user-defined menu by specifying the menu name while omitting the itemName parameter. Note that if you specify an MPW built-in menu for menuName or the option -help to designate the Help menu, DeleteMenu deletes all user-defined menu items within those menus.

To delete a specific user-defined menu item from a menu, you specify both menuName and itemName on the command line, in the order shown on the syntax line.

INPUT

None

OUTPUT

None

STATUS

DeleteMenu can return the following status codes:

PARAMETERS

menuName

Specifies the menu name.

itemName

Specifies the menu item.

• If you specify this parameter, DeleteMenu deletes the specified menu item in the menuName menu.

• If you omit this parameter and menuName specifies a user-defined menu, DeleteMenu deletes the menu menuName.

• If you omit this parameter and menuName specifies an MPW built-in menu, DeleteMenu deletes all user-defined menu items within that menu.

Caution
If you omit both menuName and itemName, all user-defined menus and menu items are deleted. •

OPTIONS

-help

Specifies the Help menu as the menu from which any item names you specify are deleted. If you do not specify a menu item to delete, all the user-defined menu items are deleted from the Balloon Help menu.

EXAMPLES

The command line

DeleteMenu Find Top

deletes the Top menu item in the Find menu.

The following command line deletes all user-defined menu items from the Help menu.

DeleteMenu -help

LIMITATIONS

The DeleteMenu command does not delete MPW built-in menus or menu items. For example, if you have appended the Top and Bottom menu items to your Find menu, as shown in the AddMenu examples, DeleteMenu allows you to delete those menu items but not the Find menu. In addition, DeleteMenu does not allow you to delete dimmed (disabled) menu items.

SEE ALSO

AddMenu