(ВключитьПунктМеню)
Функция EnableMenuItem включает, отключает или окрашивает в серый цвет (делает недоступным) определяемый пункт меню.
Синтаксис
BOOL EnableMenuItem( HMENU hMenu, // дескриптор меню UINT uIDEnableItem, // пункт меню, который включается, // отключается или делается недоступным UINT uEnable // флажки пункта меню );
Параметры
hMenu
Идентифицирует меню.
uIDEnableItem
Определяет пункт меню, который будет включен, выключен или сделан недоступным, как обусловлено параметром uEnable. Этот параметр устанавливает пункт в строке меню, меню, или подменю.
uEnable
Определяет флажки, которые управляют интерпретацией параметра uIDEnableItem и указывает на состояние пункта меню, т. е. включен, заблокирован или недоступен он. Этот параметр должен быть комбинацией или флажков MF_BYCOMMAND или MF_BYPOSITION и MF_ENABLED, MF_DISABLED, или MF_GRAYED:
Возвращаемые значения
Величина возвращаемого значения определяется предыдущим состоянием пункта меню (оно является, или MF_DISABLED, MF_ENABLED, или MF_GRAYED). Если пункт меню не существует, величина возвращаемого значения - 0xFFFFFFFF.
Замечания
Прикладная программа должна использовать флажок MF_BYPOSITION, чтобы определить правильный дескриптор меню. Если дескриптор меню определен для строки меню, то затрагивается пункт меню верхнего уровня (пункт в горизонтальном меню). Чтобы установить состояние пункта в "выскакивающем" меню или позицию подменю, программа должна определить дескриптор "выскакивающего " меню или подменю.
Когда приложение определяет флажок MF_BYCOMMAND, Windows отмечает значком типа "галочки" все пункты, которые открывают подменю в меню, идентифицированные при помощи определения дескриптора меню. Следовательно, если двойные пункты меню не присутствуют, достаточно определения дескриптора меню в строке меню.
Функции CreateMenu, InsertMenu, InsertMenuItem, LoadMenuIndirect, ModifyMenu и SetMenuItemInfo также могут устанавливать состояние (включения, блокировки или недоступности) меню
Смотри также
CreateMenu, GetMenuItemID, InsertMenu, InsertMenuItem, LoadMenuIndirect, ModifyMenu, SetMenuItemInfo, WM_SYSCOMMAND
Размещение и совместимость EnableMenuItem
Windows NT Да Win95 Да Win32s Да Импортируемая библиотека user32.lib Заголовочный файл winuser.h Unicode Нет Замечания по платформе Не имеется