Win32 SDK 设置/获取 CheckBox选中状态

1.CheckDlgButton函数(设置状态)

更改按钮控件的检查状态。

句法

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

参量

hDlg

类型：HWND

包含按钮的对话框的句柄。

nIDButton

类型：int

要修改的按钮的标识符。

uCheck

类型：UINT

按钮的检查状态。此参数可以是下列值之一。

表格1

值	含义
BST_CHECKED	将按钮状态设置为选中。
BST_INDETERMINATE	将按钮状态设置为灰色，表示不确定状态。仅当按钮具有BS_3STATE或BS_AUTO3STATE样式时，才使用此值。
BST_UNCHECKED	将按钮状态设置为清除

返回值

类型：布尔

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

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

备注

所述CheckDlgButton功能发送 BM_SETCHECK消息到指定对话框指定的按钮控件。

2.IsDlgButtonChecked函数（获取状态）

所述IsDlgButtonChecked函数确定的按钮控制是否被选中或三状态的按钮控制是否被选中，未选中或不确定的。

句法

UINT IsDlgButtonChecked(
  HWND hDlg,
  int  nIDButton
);

参量

hDlg

类型：HWND

包含按钮控件的对话框的句柄。

nIDButton

类型：int

按钮控件的标识符。

返回值

类型：UINT

使用BS_AUTOCHECKBOX，BS_AUTORADIOBUTTON，BS_AUTO3STATE，BS_CHECKBOX，BS_RADIOBUTTON或BS_3STATE样式创建的按钮的返回值可以是下表中的值之一。如果按钮具有其他样式，则返回值为零。

表格1

返回码	描述
BST_CHECKED	该按钮被选中。
BST_INDETERMINATE	该按钮处于不确定状态（仅在按钮具有BS_3STATE或BS_AUTO3STATE样式时才适用）。
BST_UNCHECKED	未选中该按钮。

备注

所述IsDlgButtonChecked功能发送BM_GETCHECK消息到指定的按钮控件。