(ВключитьПунктМеню)

Функция 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_BYCOMMAND - Указывает, что uIDEnableItem дает идентификатор пункта меню. Если ни флажок MF_BYCOMMAND, ни флажок MF_BYPOSITION не установлен, флажок MF_BYCOMMAND является флажком, заданным по умолчанию.
• MF_BYPOSITION - Указывает, что uIDEnableItem дает отсчитываемую от нуля относительную позицию пункта меню.
• MF_DISABLED - Указывает, что пункт меню заблокирован, а не недоступный, так что он не может быть выбран.
• MF_ENABLED - Указывает, что пункт меню включен и восстановлен из недоступного состояния так, чтобы он мог быть выбран.
• 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				Нет
Замечания по платформе		Не имеется