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
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 windows 8 中引入的 ext-ms-win-ntuser-dialogbox-l1-1-0 ()

另请参阅

CheckDlgButton