CListBox::Create

更新 : 2007 年 11 月

Windows のリスト ボックスを作り、CListBox オブジェクトに結び付けます。

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

パラメータ

  • dwStyle
    リスト ボックスのスタイルを指定します。ボックスには任意のリスト ボックス スタイルの組み合わせを指定できます。

  • rect
    リスト ボックスのサイズと位置を指定します。CRect オブジェクトか RECT 構造体のどちらでも使えます。

  • pParentWnd
    リスト ボックスの親ウィンドウ (通常は CDialog オブジェクト) を指定します。NULL は指定できません。

  • nID
    リスト ボックスのコントロール ID を指定します。

戻り値

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

解説

CListBox オブジェクトは、次の手順で構築します。まずコンストラクタを呼び出します。次に Create 関数を呼び出して、Windows のリスト ボックスを初期化し、CListBox オブジェクトに結び付けます。

Create 関数が実行されると、Windows は WM_NCCREATEWM_CREATEWM_NCCALCSIZEWM_GETMINMAXINFO の各メッセージをリスト ボックス コントロールに送ります。

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

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

  • WS_CHILD   常時

  • WS_VISIBLE   通常

  • WS_DISABLED   まれ

  • WS_VSCROLL   垂直スクロール バーを追加

  • WS_HSCROLL   水平スクロール バーを追加

  • WS_GROUP   コントロールをグループ化します。

  • WS_TABSTOP   コントロールのタブ オーダーを指定

使用例

// pParentWnd is a pointer to the parent window.
m_myListBox.Create(WS_CHILD|WS_VISIBLE|LBS_STANDARD|WS_HSCROLL, 
   CRect(10,10,200,200), pParentWnd, IDC_MYLISTBOX);

必要条件

ヘッダー : afxwin.h

参照

参照

CListBox クラス

階層図

CListBox::CListBox

その他の技術情報

CListBox のメンバ