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

  • Статья

Проверяет указанный пункт меню и делает его элементом-переключателем. В то же время функция очищает все остальные пункты меню в связанной группе и очищает флаг типа переключателя для этих элементов.

Синтаксис

BOOL CheckMenuRadioItem(
  [in] HMENU hmenu,
  [in] UINT  first,
  [in] UINT  last,
  [in] UINT  check,
  [in] UINT  flags
);

Параметры

[in] hmenu

Тип: HMENU

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

[in] first

Тип: UINT

Идентификатор или позиция первого пункта меню в группе.

[in] last

Тип: UINT

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

[in] check

Тип: UINT

Идентификатор или положение элемента меню, проверка.

[in] flags

Тип: UINT

Указывает значение значений idFirst, idLast и idCheck. Если этот параметр MF_BYCOMMAND, другие параметры указывают идентификаторы пунктов меню. Если это MF_BYPOSITION, другие параметры указывают позиции пунктов меню.

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

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Комментарии

Функция CheckMenuRadioItem устанавливает флаг типа MFT_RADIOCHECK и состояние MFS_CHECKED для элемента, указанного idCheck , и одновременно очищает оба флага для всех остальных элементов в группе. Выбранный элемент отображается с использованием точечного изображения маркеров вместо растрового изображения проверка метки.

Дополнительные сведения о типе пункта меню и флагах состояния см. в разделе Структура MENUITEMINFO .

Примеры

Пример см. в разделе Пример использования точечных изображений пользовательских флажок.

Требования

   
Минимальная версия клиента 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)

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

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

MENUITEMINFO

Меню

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