CTreeCtrl::Create

更新 : 2007 年 11 月

ツリー ビュー コントロールをダイアログ ボックス テンプレートで指定するか、または CTreeView を使用すると、ダイアログ ボックスまたはビューを作成したときに、自動的にツリー ビュー コントロールが作成されます。

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

パラメータ

  • dwStyle
    ツリー ビュー コントロールのスタイルを指定します。「CreateWindow」で説明するウィンドウ スタイル、および Windows SDK で説明するツリー ビュー コントロールのスタイルの組み合わせを適用します。

  • rect
    ツリー ビュー コントロールのサイズと位置を指定します。CRect オブジェクトまたは RECT 構造体のいずれかを指定します。

  • pParentWnd
    ツリー ビュー コントロールの親ウィンドウ (通常は CDialog です) を指定します。NULL は指定できません。

  • nID
    ツリー ビュー コントロールの ID を指定します。

戻り値

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

解説

Create メンバ関数は、ツリー ビュー コントロールを他のウィンドウの子ウィンドウとして作成するときに使用します。Create でツリー ビュー コントロールを作成する場合は、WS_VISIBLE をほかのツリー ビュー スタイルと一緒に渡す必要があります。

CTreeCtrl は 2 ステップで構築します。まず、コンストラクタを呼び出します。それから Create を呼び出してツリー ビュー コントロールを作成し、それを CTreeCtrl オブジェクトに結び付けます。

拡張ウィンドウ スタイルを使用してツリー ビュー コントロールを作成する場合は、Create ではなく CreateEx を呼び出します。

使用例

// Assuming your window has a CTreeCtrl member named m_TreeCtrl,
// you can create the tree control window with a child ID of ID_MYTREE
// using a call like this:

m_TreeCtrl.Create(WS_VISIBLE | WS_TABSTOP | WS_CHILD | WS_BORDER
   | TVS_HASBUTTONS | TVS_LINESATROOT | TVS_HASLINES
   | TVS_DISABLEDRAGDROP | TVS_NOTOOLTIPS | TVS_EDITLABELS,
   CRect(10, 10, 300, 100), this, ID_MYTREE);

// The control will have the appropiate window styles, and the tree
// control styles specified are those most commonly used.

必要条件

ヘッダー : afxcmn.h

参照

参照

CTreeCtrl クラス

階層図

CTreeCtrl::CTreeCtrl

その他の技術情報

CTreeCtrl のメンバ