Home > Element Reference : Treecol

Contents

### Treecol

A column of a tree. It displays the column header and holds the size and other information about the column. You can also place splitter elements between the columns to allow column resizing.

More information about Treecol

#### Attributes:

Attributes inherited from XUL Element

crop

If the label of the treecol is too small to fit in its given space, the text will be cropped on the side specified by the crop attribute. An ellipsis will be placed in place of the cropped text. If the box direction is right to left (rtl), the cropping is reversed.

- start: The text will be cropped on its left side.
- end: The text will be cropped on its right side.
- left: (Deprecated) The text will be cropped on its left side.
- right: (Deprecated) The text will be cropped on its right side.
- center: The text will be cropped on both sides.
- none: The text will be not be cropped using an ellipsis. However, the text will simply be cut off if it is too large. The side depends on the CSS text alignment.

cycler

If true, then the column is a cycler column. In the case, clicking on a cell in the column will alternate its state between on and off. This is used, for example im a mail window, for a column that indicates that the message is read or unread with a small mark in the cell. If cycler attribute is not set, the cell is a regular text cell.

fixed

If true, the size of the column in the tree cannot be adjusted by the user. Any splitters to either side will resize those columns while keeping the fixed column at a constant size. If false or not specified, the user can adjust the size of the column, typically by dragging the column header with the mouse.

hidden

This attribute, when set to true, hides the column. The user can show the column by selecting it from a drop-down at the end of the column header row.

label

The label that will appear on the treecol. If this is left out, no text appears.

primary

If set to true, the column will have indentation and twisties drawn to the left of it to indicate the hierarchy level of the rows. If no column has the primary attribute set to true, the tree may still contain nested rows, although no indication will be given to the user.

sort

Set this to a RDF property to have the data in the column sorted based on that property. The property will generally be the same as that of the cell labels.

sortActive

This should be set to true for the column which should be sorted by default.

sortDirection

Set this attribute to set the direction the column is sorted. The user may change the sort direction by clicking the column headers.

- ascending: The data is sorted in ascending order.
- descending: The data is sorted in descending order.
- natural: The data is sorted in natural order, which means the order that it is stored in.

#### Properties and Methods:

Properties and Methods inherited from XUL Element

Copyright (C) 1999 - 2002 XULPlanet.com