CExtTreeCtrl

Professional User Interface Suite, Copyright FOSS Software Inc. Help Published with Permission.
class CExtTreeCtrl : public CTreeCtrl

Remarks

The CExtTreeCtrl class implements an advanced version of the tree view common control. It supports true color icons when running on old Windows versions, disabled items, multiple item selection, check boxes and radio button groups for selective items, edit, combo box and progress controls attached to tree items. This class also contains a set of handy methods for working with tree items.

Header

ExtControlsCommon.h

Constants

The CExtTreeCtrl::delayed_focus_event_type_t enumeration specifies flags used in the LPARAM parameter of the delayed focus event notification implemented as a CExtTreeCtrl::g_nMsgTreeItemDelayedFocus registered message. The delayed focus notification allows the user to walke through tree items and process focused item change even only after some delay when the user does not press up or down arrow keys.

Value Meaning
__PARM_DELAYED_FOCUS_BEGIN_WAITING Indicates if the delayed focus event started. If this flag is not set, the delayed focus tracking is finished and the application can handle the focused item change event.
__PARM_DELAYED_FOCUS_MOUSE_CLICK Indicates whether the focused item selection was performed by mouse click.

The CExtTreeCtrl::e_check_box_type_t enumeration lists the types of the check box that can appear next to the tree item's label on the left.

Value Meaning
e_cbt_none No check box.
e_cbt_radio Radio button.
e_cbt_check_box Two-state check box.
e_cbt_tri_state_check_box Tree state check box.

The CExtTreeCtrl::e_item_control_type_t enumeration lists the types of the control that can appear next to the tree item's label on the right.

Value Meaning
__EICT_NONE No control.
__EICT_EDIT Single line editor.
__EICT_DROPDOWN_COMBOBOX Drop-down combo box.
__EICT_DROPLIST_COMBOBOX Drop-list combo box control.
__EICT_PROGRESS_BAR_THEMED Themed progress bar.
__EICT_PROGRESS_BAR_WITH_BOXES Classic progress bar.
__EICT_PROGRESS_BAR_SMOOTH Classic smooth progress bar.
__EICT_PROGRESS_BAR_ENDLESS Endless progress bar.

The CExtTreeCtrl::e_line_style_t enumeration lists the types of hierarchy line lines.

Value Meaning
line_style_solid Solid line.
line_style_dots Dot line.

The CExtTreeCtrl::e_line_type_t enumeration lists the types of hierarchy line elements at the item level is drawn.

Value Meaning
line_empty Empty (no drawn).
line_corner Corner consisting of two lines: from top to center and from center to right.
line_beam Vertical element.
line_branch Middle element consisting of two lines: from top to bottom and from center to right.

The CExtTreeCtrl::e_tree_box_style_t enumeration lists the types of the expand/collapse button.

Value Meaning
tree_box_style_square Square.
tree_box_style_round Round.
tree_box_style_bitmap Bitmap.

The CExtTreeCtrl::e_tree_item_rect_type_t enumeration lists all inner parts of a tree item. These parts are used for drawing and hit-testing a tree item.

Value Meaning
e_tirt_entire Entire item.
e_tirt_line_area Hierarchy line.
e_tirt_tree_box Tree box area.
e_tirt_check_box Check box or radio button on the left of the label.
e_tirt_icon Icon that is painted next to the check box or radio button on the left.
e_tirt_label Label.
e_tirt_control Control on the right of the label.
e_tirt_right_part Empty space on the right of the tree item.

The following basic flags can be accessed and modified with the TreeGetStyle() and TreeModifyStyle() methods:

Value Meaning
__EXT_TREE_MULTIPLE_SELECTION Multiple items can be selected.
__EXT_TREE_SELECT_DISABLE_ITEMS Disabled items can be selected.
__EXT_TREE_FOCUS_DISABLE_ITEMS Disabled items can be focused.
__EXT_TREE_SELECT_COLLAPSED_ITEMS When an item becomes selected, its child items become selected too.
__EXT_TREE_SUBTRACT_SELECTION Subtract selection.
__EXT_TREE_HOVER_DISABLE_ITEMS Hover effect for disabled items.
__EXT_TREE_AUTO_DISABLE_ITEMS_BY_PARENT When an item becomes disabled, its child items become disabled too.

The following extended flags can be accessed and modified with the TreeGetStyleEx() and TreeModifyStyleEx() methods:

Value Meaning
__EXT_TREE_EX_HOVER_TREE_BOXES Hover effect for tree boxes.
__EXT_TREE_EX_HOVER_CHECK_BOXES Hover effect for check boxes.
__EXT_TREE_EX_HOVER_RADIO_BUTTONS Hover effect for radio buttons.

See Also

Class Members | Hierarchy Chart