TreeCombo

Inheritance Hierarchy

          IComponent

          IControl

          ITreeControl

          ITreeCombo

          TreeCombo

Description

The TreeCombo component is used to display tree-like hierarchical structures, such as an object inheritance tree, in the form of drop-down lists.

Working with the Component

Select the component elements by clicking on the element icon or on the element itself, or pressing the space key.

Double-clicking the column border automatically fits the left column. The width is adjusted based on all elements that the node contains (including expander, flag, icon, status icon or node text).

NOTE. You can resize the drop-down list of elements by dragging its right, left or bottom border with your mouse. The minimum width of the drop-down list equals to the component width.

By default information on the element selection is displayed in the component editor. To update this information automatically, the  AutoUpdateInfo property is used. To display user data in the component editor, the basic property  Text must be changed.

Element Search

The following types of search are available from the expanded drop-down list:

• On typing in first several characters of the element name the cursor moves to the first found element. This type of search is performed in cycles, and only by the elements in the expanded part of element tree hierarchy.

• In the search bar which opens on clicking F3 or CTRL+F. The search is started after the user enters required character string and presses ENTER or clicks . Search is done in cycles by all the element hierarchy.

If search has been successful, the cursor will focus on the found element. Selection state depends on value of the  FindMode property. Depending on selected multiple selection mode, you can add an element to selection either by selecting it using the Space key or selecting it with the mouse cursor while holding down the CTRL key.

You can also search for elements with the component drop-down list collapsed. When the component is focused, entering a set of characters creates a list of elements whose names contain this set of characters:

Elements are selected using the previously noted method, depending on the value defined in the  SelectionMode property. Closing this dialog box applies the selection to the component.

You can search for one or several words based on segments in any mode. To do this, separate the search combinations with whitespace character. The word order in the names of search elements is ignored.

Sorting Data

Data sorting is available if the  ShowColumnHeaders, Sorted  and the  ColumnClick  properties have the True value, and the  SortType  property has a value other than None.

When you are in the form executing mode, click the caption of the appropriate column to sort data by it. The data are sorted ascending. Double-clicking changes the sorting direction. To sort data by multiple columns, click the headings of the required columns while holding down CTRL key. The sorting order is as follows: the column whose caption is clicked last is sorted last.

Sorting parameters can also be defined in the Sorting specialized dialog box:

This dialog box opens when selecting the appropriate item from the context menu called from the column heading area.

NOTE. The context menu option is available if the  ShowColumnHeaders  and  Sorted  properties are set to True, and the  SortType  property should have a value other than None.

Move the columns used to sort by to the selection list. The and the buttons are used to change sorting direction by the selected column. The and the buttons are used to change the sorting order. Columns at the top of the list are sorted first.

In Fore language, to apply sorting, you need to set the  Sorted  property to True, and the  SortType  property should have a value other than None. The column data of which is sorted is defined in the  SortColumn property. Sorting direction is defined in the  SortAscending  property of the corresponding column.

The  Sort  and  SortDefault methods can also be used to manage sorting.

Example

Properties of the TreeCombo Component

Methods of the TreeCombo Component

Events of the TreeCombo Component

See also:

Additional Components