CWnd::CheckDlgButton

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ボタンを選択 (ボタンの右横にチェックマークを付ける) またはクリア (ボタンからチェックマークをはずす) します。また、3 ステートボタンの状態を変更します。

void CheckDlgButton(
   int nIDButton,
   UINT nCheck 
);

パラメータ

nIDButton
変更するボタンを指定します。
nCheck
動作を指定します。nCheck が 0 以外のときは、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
}