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	将按钮状态设置为选中。
BST_INDETERMINATE	将按钮状态设置为灰色，指示不确定状态。仅当按钮具有 BS_3STATE 或 BS_AUTO3STATE 样式时，才使用此值。
BST_UNCHECKED	将按钮状态设置为已清除

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

CheckDlgButton 函数将BM_SETCHECK消息发送到指定对话框中的指定按钮控件。

有关示例，请参阅使用对话框中的创建无模式对话框。


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	windows 8 中引入的 ext-ms-win-ntuser-dialogbox-l1-1-0 ()

引用