Функция CheckMenuRadioItem отмечает "кружочком" заданный пункт меню и делает его пунктом с “радиокнопкой”. Одновременно, функция снимает отметку "кружочком " во всех других пунктах меню в связанной группе и очищает эти пункты от флажков пункта с “радиокнопкой”.
Синтаксис
BOOL CheckMenuRadioItem( HMENU hmenu, UINT idFirst, UINT idLast, UINT idCheck, UINT uFlags ); |
Параметры
hmenu
[in] Дескриптор к меню, которое содержит группу пунктов меню.
idFirst
[in] Идентификатор или позиция первого пункта меню в группе.idLast
[in] Идентификатор или позиция последнего пункта меню в группе.idCheck
[in] Идентификатор или позиция пункта меню, который отмечается.uFlags
[in] Флажок, определяющий значение idFirst, idLast и idCheck. Если этот параметр - MF_BYCOMMAND, другие параметры определяют идентификаторы пунктов меню. Если он - MF_BYPOSITION, другие параметры определяют позиции пунктов меню.Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получать дополнительные данные об ошибке, используйте функцию GetLastError.
Замечания
Функция CheckMenuRadioItem устанавливает флажок типа MFT_RADIOCHECK и состояние MFS_CHECKED для пункта, определяемого параметром idCheck и, одновременно, очищает оба флажка во всех других пунктах в группе. Выбранный пункт отображается на экране, используя точечный рисунок “жирной” точки, вместо значка "галочки ".
Для получения дополнительной информации о типах пунктов меню и флажков состояния, см. структуру MENUITEMINFO.
Пример
Пример смотри в разделе Примеры статьи Пример использования пользовательских точечных рисунков "галочки".
Смотри также
Краткий обзор Меню, MENUITEMINFO
|
Размещение и совместимость CheckMenuRadioItem |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 4.0 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |