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 參數會指定按鈕標識符的範圍, () 按鈕的資源識別符。 按鈕在定位順序中的位置無關;如果按鈕形成群組的一部分,但具有超出指定範圍的標識符,則不會受到此呼叫的影響。

規格需求

需求
最低支援的用戶端 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 版)

另請參閱

CheckDlgButton

IsDlgButtonChecked

參考