CCheckListBox::Create
更新 : 2007 年 11 月
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 をオーバーライドします。
チェックリスト ボックス コントロールには、次のウィンドウ スタイルを適用できます。
WS_CHILD 常時
WS_VISIBLE 通常
WS_DISABLED まれ
WS_VSCROLL 垂直スクロール バーを追加
WS_HSCROLL 水平スクロール バーを追加
WS_GROUP コントロールをグループ化します。
WS_TABSTOP コントロールのタブ オーダーを指定
必要条件
ヘッダー : afxwin.h