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

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

CheckRadioButton 関数は、指定されたグループ内の各ラジオ ボタンにBM_SETCHECK メッセージを送信します。

nIDFirstButton パラメーターと nIDLastButton パラメーターは、ボタン識別子の範囲 (通常はボタンのリソース ID) を指定します。 タブ オーダー内のボタンの位置は関係ありません。ボタンがグループの一部を形成するが、指定された範囲外の ID を持つ場合、この呼び出しの影響を受けられません。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-dialogbox-l1-1-2 (Windows 10 バージョン 10.0.10240 で導入)

こちらもご覧ください

CheckDlgButton

IsDlgButtonChecked

参照