Tree Object

The tree object allows you to display a hierarchal list of items on the page or dialog in the well known 'tree' format. Items can have checkboxes associated with them, or simply be selectable. There are a variety of powerful options making this object extremely robust.

Each item in the tree can hold child elements. Any parent item can be forced to be expanded at runtime by default. You have full control over what the user sees with this object, and how they can interact with it. A plethora of events are included to make this object fully functional. Each item consists of a single line of text, and an optional string of internal data that can be associated with the item. The item text is the visible part; it's what shows up in the tree, and it's what the user will see as the item. The item data is an optional invisible part; it doesn't show up in the list, and is only visible when performing actions on the object.

The tree object has an extensive action set so you can load and manipulate tree items at run time for full flexibility.

The object also contains a series of visible properties that can be controlled. Some of these settings include whether checkboxes will be shown, whether or not the user can edit the items within the tree, and what images (if any) are shown next to each item when the item is either selected or not selected.

Tip: You can add a tree object by choosing Object > Tree from the menu.