Component Editor
- 3 minutes to read
The ExpressQuantumTreeList control provides an advanced Component Editor, which allows you to customize bands and columns at design time.
To invoke the Component Editor, click the Bands… or Columns… item in the control’s context menu or double-click the control.
Bands page
This page allows you to:
Create and delete bands.
Reposition bands within the TreeList control.
Access individual bands and display their properties in the Object Inspector. This is useful for hidden fields, since all the visible bands can be accessed via on-form object access provided by the ExpressQuantumTreeList.
The list within this page displays the bands contained within the TreeList control’s Bands collection. Each band in the list is identified by its Caption.Text property value. You can customize the settings for multiple selected bands simultaneously. Hold down the Shift or Ctrl keys while clicking bands to modify the selection. The settings of the currently selected band(s) can be accessed and changed via the Object Inspector.
The following table lists all the buttons available within the Bands page, along with descriptions of their purpose.
| Button | Description |
|---|---|
| Add | Adds a new band. This band is automatically selected within the list. |
| Delete | Removes the selected band from the list and the Bands collection. This doesn’t remove the band’s columns or child bands. |
| Move Up | Moves the selected band to the top of the list. This decrements the band’s Index property value. |
| Move Down | Moves the selected band to the bottom of the list. This increments the band’s Index property value. |
| Restore Defaults | Restores the selected band’s default option settings and width. Clicking this button calls the band’s RestoreDefaults method. |
| Restore Widths | Restores the selected band’s default width. Clicking this button calls the band’s RestoreWidths method. |
Columns page
This page allows you to:
Create and delete columns.
Reposition columns within the TreeList control.
Access individual columns and display their properties in the Object Inspector.
Automatically create columns for all the fields in a bound data source.
The list within this page displays the columns contained within the TreeList control’s Columns collection. Each column in the list is identified by its Name property value and the parent band‘s caption. As with bands, you can customize the settings for multiple selected columns simultaneously. Hold down the Shift or Ctrl keys while clicking columns to modify the selection. The settings of the currently selected column(s) will be displayed in the Object Inspector.
The following table lists all the buttons available within the Columns page along with descriptions of their purpose.
Button | Description |
|---|---|
Add | Adds a new column to the first visible band. This column is automatically selected within the list. |
Delete | Removes the selected column from the list and the Columns collection. |
Move Up | Moves the selected column to the top of the list. This decrements the column’s ItemIndex property value. |
Move Down | Moves the selected band to the bottom of the list. This increments the column’s ItemIndex property value. |
Restore Defaults | Restores the selected column’s default option settings and width. Clicking this button calls the column’s RestoreDefaults method. |
Restore Widths | Restores the selected column’s default width. Clicking this button calls the column’s RestoreWidths method. |
Create all fields | Available only for data-aware TreeList controls. Creates columns for all the fields in a bound data source. The created columns are positioned within the first visible band. The names of the created columns are assigned automatically. |
The Bands or Columns list’s context menu items provide the same functionality as buttons on corresponding pages, and allow you to select all items within the list.
