CCheckListBox::Create

2011-08-09

Windows のチェックリストボックスを作成し、CCheckListBox オブジェクトに結び付けます。

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

パラメーター

dwStyle
チェックリストボックスのスタイルを指定します。スタイルは、LBS_HASSTRINGS および LBS_OWNERDRAWFIXED (リスト内の全アイテムに同じ高さを設定) または LBS_OWNERDRAWVARIABLE (リスト内のアイテムの高さが異なる) のいずれかにする必要があります。このスタイルは、LBS_USETABSTOPS 以外のほかのリストボックススタイルと組み合わせて設定できます。
rect
チェックリストボックスのサイズと位置を指定します。 CRect オブジェクトまたは RECT 構造体のいずれかを指定できます。
pParentWnd
チェックリストボックスの親ウィンドウ (通常は CDialog オブジェクト) を指定します。 NULL は指定できません。
nID
チェックリストボックスのコントロール ID を指定します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

CCheckListBox オブジェクトは、次の手順で構築します。まず、CcheckListBox の派生クラスを定義します。その後、Create を呼び出し、Windows のチェックリストボックスを初期化し、CCheckListBox オブジェクトに結び付けます。サンプルについては、「CCheckListBox::CCheckListBox」を参照してください。

Create が実行されると、Windows は、チェックリストボックスコントロールに WM_NCCREATE、WM_CREATE、WM_NCCALCSIZE および WM_GETMINMAXINFO メッセージを送ります。

既定では、これらのメッセージは CWnd 基本クラスのメンバー関数 OnNcCreate、OnCreate、OnNcCalcSize および OnGetMinMaxInfo によって処理されます。既定のメッセージ処理を拡張するには、CCheckListBox の派生クラスを作成し、新しいクラスにメッセージマップを追加します。さらに、上記のメッセージハンドラーメンバー関数をオーバーライドします。新しいクラスに必要な初期化を行う場合などに、OnCreate をオーバーライドします。

チェックリストボックスコントロールには、次のウィンドウスタイルを適用できます。