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


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

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

Синтаксис

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

Параметры

[in] hDlg

Тип: HWND

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

[in] nIDButton

Тип: int

Идентификатор изменяемой кнопки.

[in] uCheck

Тип: UINT

Состояние проверка кнопки. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
BST_CHECKED
Устанавливает состояние кнопки в значение checked.
BST_INDETERMINATE
Задает для кнопки серый цвет, указывая неопределенное состояние. Используйте это значение, только если кнопка имеет стиль BS_3STATE или BS_AUTO3STATE .
BST_UNCHECKED
Устанавливает для кнопки состояние "Очищено"

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

Тип: BOOL

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

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

Комментарии

Функция CheckDlgButton отправляет сообщение BM_SETCHECK указанному элементу управления "Кнопка" в указанном диалоговом окне.

Примеры

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

Требования

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

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

CheckRadioButton

IsDlgButtonChecked

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