hiDisableMenuItem
hiDisableMenuItem(
r_hiMenu
s_itemHandle
[ w_windowId ]
)
=> t / nil
Description
Grays out a menu item on pull-down, pop-up, or fixed menus, making it unselectable.
Unless otherwise specified, all menu items are selectable when they are created.
Arguments
|
r_hiMenu
|
Menu created with hiCreateMenu, hiCreatePulldownMenu, hiCreateHorizontalFixedMenu, or hiCreateVerticalFixedMenu.
|
|
s_itemHandle
|
SKILL menu item handle specified when the menu item was created with hiCreateMenuItem or hiCreateSliderMenuItem, or when the action was created with hiCreateAction.
|
|
w_windowId
|
Window argument created with hiCreateWindow or hiOpenWindow. If this argument is used, only the menu item in a menu on this window is disabled. This is useful for shared menus, when you want to disable a menu item in one menu only and leave the other occurrences of the same menu item enabled. This argument is also necessary when disabling a menu item on a window fixed menu.
|
Values Returned
|
t
|
The menu items are disabled.
|
|
nil
|
The menu items are not disabled. An error message is also issued.
|
Related Topics
Menu Functions
hiCreatePulldownMenu
hiCreateMenu
hiCreateMenuItem
hiCreateSliderMenuItem
hiCreateSeparatorMenuItem
Return to top
