Skip to main content
Version: 20 R7 BETA

DISABLE MENU ITEM

DISABLE MENU ITEM ( menu ; menuItem {; process} )

ParameterTypeDescription
menuInteger, TextMenu number or Menu reference
menuItemIntegerMenu item number or -1 for the last item added
processIntegerProces reference number

This command is not thread-safe, it cannot be used in preemptive code.

Description

The DISABLE MENU ITEM command disables the menu item whose menu number or reference is passed in menu and whose item number is passed in menuItem.You can pass -1 in menuItem in order to designate the last item added to the menu.

If you omit the process parameter, DISABLE MENU ITEM applies to the menu bar for the current process. Otherwise, DISABLE MENU ITEM applies to the menu bar for the process whose reference number is passed in process.

If the menuItem parameter designates a hierarchical submenu, all the items of this menu and any submenus are disabled. This command also works with a menu bar created using the Create menu command and installed with the SET MENU BAR command.

Note: If you pass a MenuRef in menu, the process parameter serves no purpose and will be ignored.

Tip: To enable/disable all items of a menu at once, pass 0 (zero) in menuItem.

See also

ENABLE MENU ITEM