CheckDlgButton 関数 (winuser.h)

  • [アーティクル]

ボタン コントロールのチェック状態を変更します。

構文

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

パラメーター

[in] hDlg

種類: HWND

ボタンを含むダイアログ ボックスのハンドル。

[in] nIDButton

型: int

変更するボタンの識別子。

[in] uCheck

型: UINT

ボタンのチェック状態。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
BST_CHECKED
 ボタンの状態をオンに設定します。
BST_INDETERMINATE
 ボタンの状態を灰色に設定し、不確定状態を示します。 ボタンに BS_3STATEまたはBS_AUTO3STATE スタイルがある場合にのみ、この値 を 使用します。
BST_UNCHECKED
 ボタンの状態をクリアに設定します

戻り値

種類: BOOL

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

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

解説

CheckDlgButton 関数は、指定したダイアログ ボックスの指定したボタン コントロールにBM_SETCHECKメッセージを送信します。

例

例については、「ダイアログ ボックスの使用」の「モードレス ダイアログ ボックスの作成」を参照してください。

要件

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

関連項目

CheckRadioButton

IsDlgButtonChecked

参照