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

Статья
08/27/2023

[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)