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訊息傳送至指定群組中的每個單選按鈕。
nIDFirstButton 和 nIDLastButton 參數會指定按鈕標識符的範圍, () 按鈕的資源識別符。 按鈕在定位順序中的位置無關;如果按鈕形成群組的一部分,但具有超出指定範圍的標識符,則不會受到此呼叫的影響。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包含 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-dialogbox-l1-1-2 (Windows 10 10.0.10240 版) |
另請參閱
參考