4D Doc Center : DISABLE MENU ITEM

Home

4D v14.3

DISABLE MENU ITEM


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

Parameter	Type	Description
menu	Longint, MenuRef	Menu number or Menu reference
menuItem	Longint	Menu item number or -1 for the last item added
process	Longint	Proces reference number

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.