CheckDlgButton 関数 (winuser.h)
ボタン コントロールのチェック状態を変更します。
構文
BOOL CheckDlgButton(
[in] HWND hDlg,
[in] int nIDButton,
[in] UINT uCheck
);
パラメーター
[in] hDlg
種類: HWND
ボタンを含むダイアログ ボックスのハンドル。
[in] nIDButton
型: int
変更するボタンの識別子。
[in] uCheck
型: UINT
ボタンのチェック状態。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
ボタンの状態をオンに設定します。 |
|
ボタンの状態を灰色に設定し、不確定状態を示します。 ボタンに BS_3STATEまたはBS_AUTO3STATE スタイルがある場合にのみ、この値 を 使用します。 |
|
ボタンの状態をクリアに設定します |
戻り値
種類: 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 で導入) |
関連項目
参照