(ПолучитьСостояниеМеню)

Функция GetMenuState извлекает данные о флажках меню, связанные с определяемым пунктом меню. Если пункт меню открывает подменю, эта функция, к тому же, возвращает число пунктов в подменю.

Функция GetMenuState была заменена функцией GetMenuItemInfo. Вы можете все еще использовать GetMenuState, в том случае, если вам не нужно какая-либо из расширенных функций GetMenuItemInfo.

Синтаксис

UINT GetMenuState(
	HMENU hMenu,	// дескриптор меню
	UINT uId,		// запрошенный пункт меню
	UINT uFlags	// флажки меню
);

Параметры hMenu
Идентифицирует меню, которое содержит пункт, чьи флажки должны быть получены.
uId
Определяет пункт меню, флажки которого должны быть получены, как определяется параметром uFlags.
uFlags
Определяет, как интерпретировать параметр универсального идентификатора. Этот параметр может быть одним из следующих значений:

• MF_BYCOMMAND - Обозначает, что параметр uId дает идентификатор пункта меню. Флажок MF_BYCOMMAND – это значение по умолчанию, если ни флажок MF_BYCOMMAND, ни флажок MF_BYPOSITION не установлены.
• MF_BYPOSITION - Обозначает, что параметр uId дает отсчитываемую от нуля относительную позицию пункта меню.

Возвращаемые значения
Если определяемый пункт не существует, величина возвращаемого значения - 0xFFFFFFFF.
Если пункт меню открывает подменю, младший байт величины возвращаемого значения содержит флажки меню, связанные с пунктом, а старший байт содержит число пунктов в подменю, открываемых при помощи этого пункта.
Иначе, величина возвращаемого значения - маска (Булево OR (ИЛИ)) флажков меню. Ниже перечислены флажки меню, связанные с пунктом меню:

• MF_CHECKED - Помещает «галочку» рядом с пунктом (только для "выскакивающих" меню, подменю и контекстных меню).
• MF_DISABLED - Отключает пункт.
• MF_GRAYED - Отключает и делает недоступным пункт.
• MF_HILITE - Выделяет пункт.
• MF_MENUBARBREAK - Исполняет функцию такую же как и флажок MF_MENUBREAK, за исключением "выскакивающих" меню, подменю и контекстных меню, где новый столбец отделяется от старого столбца вертикальной строкой.
• MF_MENUBREAK - Размещает пункт на новой строке (для горизонтального меню) или в новом столбце (для "выскакивающих" меню, подменю и контекстных меню), без разделения столбцов.
• MF_SEPARATOR - Создает горизонтальную разделительную линию (только для "выскакивающих" меню, подменю и контекстных меню).

Смотри также
GetMenu, GetMenuItemCount, GetMenuItemID, GetMenuItemInfo, GetMenuString

Размещение и совместимость GetMenuState

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		user32.lib 
Заголовочный файл			winuser.h 
Unicode				Нет 
Замечания по платформе		Не имеется