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

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

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

Syntax

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

Parameters

[in] hMenu

Тип: HMENU

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

[in] uIDCheckItem

Тип: UINT

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

[in] uCheck

Тип: UINT

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

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

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

Тип: DWORD

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

Замечания

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

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

Examples

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

Требования

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

См. также

Концептуальный

EnableMenuItem

GetMenuItemID

Меню

Ссылки

SetMenuItemBitmaps

SetMenuItemInfo