Поделиться через


Функция CheckMenuItem (winuser.h)

[CheckMenuItem доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте SetMenuItemInfo. ]

Задает состояние атрибута проверка метки указанного элемента меню как выбранное или прозрачное.

Синтаксис

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

Параметры

[in] hMenu

Тип: HMENU

Дескриптор интересующего меню.

[in] uIDCheckItem

Тип: UINT

Элемент меню, атрибут проверка которого должен быть задан, как определено параметром uCheck.

[in] uCheck

Тип: UINT

Флаги, управляющие интерпретацией параметра uIDCheckItem и состоянием атрибута проверка метки элемента меню. Этот параметр может быть сочетанием MF_BYCOMMAND или MF_BYPOSITION и MF_CHECKED или MF_UNCHECKED.

Значение Значение
MF_BYCOMMAND
0x00000000L
Указывает, что параметр uIDCheckItem дает идентификатор пункта меню. По умолчанию используется флаг MF_BYCOMMAND , если не указан флаг MF_BYCOMMAND или MF_BYPOSITION .
MF_BYPOSITION
0x00000400L
Указывает, что параметр uIDCheckItem задает отсчитываемую от нуля относительную позицию элемента меню.
MF_CHECKED
0x00000008L
Задает для атрибута проверка метки выбранное состояние.
MF_UNCHECKED
0x00000000L
Задает для атрибута проверка метки состояние clear.

Возвращаемое значение

Тип: DWORD

Возвращаемое значение указывает предыдущее состояние пункта меню ( MF_CHECKED или MF_UNCHECKED). Если элемент меню не существует, возвращается значение –1.

Комментарии

Элемент в строке меню не может иметь проверка метку.

Параметр uIDCheckItem определяет элемент, открывающий подменю или командный элемент. Для элемента, открывающего подменю, параметр uIDCheckItem должен указывать положение элемента. Для командного элемента параметр uIDCheckItem может указать положение элемента или его идентификатор.

Примеры

Пример см. в разделе Имитация флажок в меню.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-menu-l1-1-0 (появилось в Windows 8)

См. также раздел

Основные понятия

EnableMenuItem

GetMenuItemID

Меню

Справочные материалы

SetMenuItemBitmaps

SetMenuItemInfo