Share via


CWnd::CheckDlgButton

(の横にチェック マーク場所) またはクリア (削除) ボタンのチェック マークで選択するか、または 3 ステート ボタンの状態が変更されます。

void CheckDlgButton(
   int nIDButton,
   UINT nCheck 
);

パラメーター

  • nIDButton
    変更するボタンを指定します。

  • nCheck
    実行するアクションを指定します。nCheck がゼロ以外の場合は、CheckDlgButton のメンバー関数は、ボタンの横にチェック マークを設定します; 0 の場合、チェック マーク削除されます。3 状態のボタンに、nCheck が 2 の場合、ボタンの状態は不確定です。

解説

CheckDlgButton の関数は、指定されたボタンに BM_SETCHECK のメッセージを送信します。

使用例

// Sets 3 check buttons in various ways.  Note BST_INDETERMINATE
// requires BS_3STATE or BS_AUTO3STATE in the button's style.
void CMyDlg::OnMarkButtons() 
{
   CheckDlgButton(IDC_CHECK1, BST_UNCHECKED);   // 0
   CheckDlgButton(IDC_CHECK2, BST_CHECKED);   // 1
   CheckDlgButton(IDC_CHECK3, BST_INDETERMINATE);   // 2
}

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::IsDlgButtonChecked

CButton::SetCheck

CheckDlgButton