Поделиться через


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

Добавляет метку проверка в (проверяет) указанный переключатель в группе и удаляет метку проверка из всех остальных переключателей в группе .

Синтаксис

BOOL CheckRadioButton(
  [in] HWND hDlg,
  [in] int  nIDFirstButton,
  [in] int  nIDLastButton,
  [in] int  nIDCheckButton
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор диалогового окна, содержащего переключатель.

[in] nIDFirstButton

Тип: int

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

[in] nIDLastButton

Тип: int

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

[in] nIDCheckButton

Тип: int

Идентификатор переключателя для выбора.

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

Тип: BOOL

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

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

Комментарии

Функция CheckRadioButton отправляет сообщение BM_SETCHECK каждому переключателю в указанной группе.

Параметры nIDFirstButton и nIDLastButton указывают диапазон идентификаторов кнопок (обычно это идентификаторы ресурсов кнопок). Положение кнопок в порядке табуляции не имеет значения; Если кнопка является частью группы, но имеет идентификатор за пределами указанного диапазона, этот вызов не влияет на нее.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-dialogbox-l1-1-2 (появилось в Windows 10 версии 10.0.10240)

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

CheckDlgButton

IsDlgButtonChecked

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