checkRadioButton 函数 (winuser.h)

将检查标记添加到 (检查) 组中指定的单选按钮,并从中删除检查标记, (清除组中所有其他单选按钮) 。

语法

BOOL CheckRadioButton(
  [in] HWND hDlg,
  [in] int  nIDFirstButton,
  [in] int  nIDLastButton,
  [in] int  nIDCheckButton
);

参数

[in] hDlg

类型: HWND

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

[in] nIDFirstButton

类型: int

组中第一个单选按钮的标识符。

[in] nIDLastButton

类型: int

组中最后一个单选按钮的标识符。

[in] nIDCheckButton

类型: int

要选择的单选按钮的标识符。

返回值

类型: BOOL

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

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

注解

CheckRadioButton 函数将BM_SETCHECK消息发送到指示组中的每个单选按钮。

nIDFirstButtonnIDLastButton 参数指定按钮标识符的范围, (通常) 按钮的资源 ID。 Tab 键顺序中的按钮位置无关紧要;如果按钮构成组的一部分,但 ID 超出指定范围,则不受此调用的影响。

要求

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

另请参阅

CheckDlgButton

IsDlgButtonChecked

引用