Share via

CTreeCtrl::Create

BOOLCreate(DWORDdwStyle**,constRECT&rect,CWnd*pParentWnd,UINTnID);**

Return Value

Nonzero if initialization was successful; otherwise 0.

Parameters

dwStyle

Specifies the tree view control’s style. Apply any combination of tree view control styles to the control.

rect

Specifies the tree view control’s size and position. It can be either a CRect object or a structure.

pParentWnd

Specifies the tree view control’s parent window, usually a CDialog. It must not be NULL.

nID

Specifies the tree view control’s ID.

Remarks

If you specify the tree control in a dialog box template, or if you are using CTreeView, your tree control is created automatically when the dialog box or view is created. If you want to create the tree control as a child window of some other window, use the Create member function. If you create the tree control using Create, you must pass it WS_VISIBLE, in addition to other tree view styles.

You construct a CTreeCtrl in two steps. First call the constructor, then call Create, which creates the tree view control and attaches it to the CTreeCtrl object.

The following styles can be applied to a tree view control:

  • TVS_HASLINES   The tree view control has lines linking child items to their corresponding parent items.

  • TVS_LINESATROOT   The tree view control has lines linking child items to the root of the hierarchy.

  • TVS_HASBUTTONS   The tree view control adds a button to the left of each parent item.

  • TVS_EDITLABELS   The tree view control allows the user to edit the labels of tree view items.

  • TVS_SHOWSELALWAYS   Causes a selected item to remain selected when the tree-view control loses focus.

  • TVS_DISABLEDRAGDROP   The tree-view control is prevented from  sending TVN_BEGINDRAG notification messages.

  • TVS_NOTOOLTIPS   The tree view control uses no tooltips.

  • TVS_SINGLEEXPAND   When this style is enabled, changing the selection in the tree view will automatically cause the item being selected to expand and the item being unselected to collapse. If the mouse is used to single-click the selected item and that item is closed, it will be expanded. If the selected item is single-clicked when it is open, it will be collapsed.

Example

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

m_TreeCtrl->Create(WS_VISIBLE | WS_TABSTOP | WS_CHILD | WS_BORDER
   | TVS_HASBUTTONS | TVS_LINESATROOT | TVS_HASLINES
   | TVS_DISABLEDRAGDROP,
   CRect(10, 10, 300, 100), this, 0x1005);

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

CTreeCtrl Overview |  Class Members |  Hierarchy Chart

See Also   CTreeCtrl::CTreeCtrl, in the Platform SDK