Функция CheckMenuItem устанавливает атрибут "галочки" заданного пункта меню в выбранное или не выбранное состояние.
Синтаксис
DWORD CheckMenuItem( HMENU hmenu, UINT uIDCheckItem, UINT uCheck ); |
Параметр
hmenu
[in] Дескриптор интересующего нас меню.uIDCheckItem
[in] Определяет пункт меню, атрибут "галочки" которого должен быть установлен, как определено параметром uCheck.uCheck
[in] Определяет флажки, которые управляют интерпретацией параметра uIDCheckItem и состоянием атрибута "галочки " пункта меню. Этот параметр может быть комбинацией или MF_BYCOMMAND, или MF_BYPOSITION и MF_CHECKED или MF_UNCHECKED.
|
Значение |
Предназначение |
|
MF_BYCOMMAND |
Указывает, что параметр uIDCheckItem дает идентификатор пункта меню. Флажок MF_BYCOMMAND является значением по умолчанию, если не установлены, ни флажок MF_BYCOMMAND, ни флажок MF_BYPOSITION. |
|
MF_BYPOSITION |
Указывает, что параметр uIDCheckItem дает отсчитываемую от нуля относительную позицию пункта меню. |
|
MF_CHECKED |
Устанавливает атрибут "галочки" в выбранное состояние. |
|
MF_UNCHECKED |
Устанавливает атрибут "галочки" в не выбранное состояние. |
Возвращаемые значения
Возвращаемое значение определяет предшествующее состояние пункта меню (или MF_CHECKED или MF_UNCHECKED). Если пункт меню не существует, возвращаемое значение равно - (минус) 1.
Замечания
| Обратите внимание! на то, что функция CheckMenuItem была заменена функцией SetMenuItemInfo. Однако Вы все еще можете использовать CheckMenuItem, если не нуждаетесь в какой-либо из дополнительных возможностей функции SetMenuItemInfo. |
Пункт в строке меню не может иметь "галочку".
Параметр uIDCheckItem идентифицирует пункт, который открывает подменю или командный пункт. Для пункта, который открывает подменю, параметр uIDCheckItem должен установить позицию пункта. Для командного пункта, параметр uIDCheckItem может установить или позицию пункта или его идентификатор.
Пример
Пример смотри в статье Моделирование окошек меток в меню.
Смотри также
Краткий обзор Меню, EnableMenuItem, GetMenuItemID, SetMenuItemBitmaps, SetMenuItemInfo
|
Размещение и совместимость CheckMenuItem |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |