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

  • Статья

Функция IsDlgButtonChecked определяет, установлен ли флажок кнопки или установлен флажок с тремя состояниями.

Синтаксис

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор диалогового окна, содержащего элемент управления "Кнопка".

[in] nIDButton

Тип: int

Идентификатор элемента управления "Кнопка".

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

Тип: UINT

Возвращаемое значение кнопки, созданной с помощью стилей BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON или BS_3STATE , может быть одним из значений в следующей таблице. Если кнопка имеет любой другой стиль, возвращаемое значение равно нулю.

Код возврата Описание
BST_CHECKED
 Кнопка флажка.
BST_INDETERMINATE
 Кнопка находится в неопределенном состоянии (применяется только в том случае, если кнопка имеет стиль BS_3STATE или BS_AUTO3STATE ).
BST_UNCHECKED
 Кнопка не выбрана.

Комментарии

Функция IsDlgButtonChecked отправляет сообщение BM_GETCHECK указанному элементу управления кнопкой.

Примеры

Пример см. в разделе "Создание безмодерного диалогового окна" статьи Использование диалоговых окон.

Требования

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

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

CheckDlgButton