IsDlgButtonChecked 函数 (winuser.h)

IsDlgButtonChecked 函数确定是选中按钮控件,还是选中、未选中还是不确定三态按钮控件。

语法

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

参数

[in] hDlg

类型: HWND

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

[in] nIDButton

类型: int

按钮控件的标识符。

返回值

类型: UINT

使用BS_AUTOCHECKBOXBS_AUTORADIOBUTTON、BS_AUTO3STATEBS_CHECKBOXBS_RADIOBUTTONBS_3STATE样式创建的按钮的返回值可以是下表中的值之一。 如果按钮具有任何其他样式,则返回值为零。

返回代码 说明
BST_CHECKED
已选中按钮。
BST_INDETERMINATE
该按钮处于不确定状态 (仅当按钮具有 BS_3STATEBS_AUTO3STATE 样式) 时才适用。
BST_UNCHECKED
未选中按钮。

注解

IsDlgButtonChecked 函数将BM_GETCHECK消息发送到指定的按钮控件。

示例

有关示例,请参阅 使用对话框中的标题为“创建无模式对话框”的部分。

要求

   
最低受支持的客户端 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 ()

另请参阅

CheckDlgButton