Функция 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) |
См. также раздел
Основные понятия
Справочные материалы