Tree Widget
The Tree widget displays a tree when you are using a dataset. This dataset should have an Id for its each row and also information about the parent Id of each row.
Properties
For information about common widget properties, see Widgets. Properties that are specific to the Tree widget are described in the table below.
|
Property Name
|
Description
|
Base Type
|
Default Value
|
Bindable? (Y/N)
|
Localizable? (Y/N)
|
|---|---|---|---|---|---|
|
CustomClass
|
User defined CSS class to apply to the top div of the widget. Multiple classes can be entered, separated by a space.
|
STRING
|
n/a
|
Y
|
N
|
|
AutoSelectFirstRow
|
Automatically displays the first row of data when new data is entered
|
BOOLEAN
|
False
|
N
|
N
|
|
LabelField
|
Field to use for tree labels
|
n/a
|
n/a
|
N
|
N
|
|
TooltipField
|
Field to use for tooltips
|
n/a
|
n/a
|
N
|
N
|
|
ValueField
|
Field to use for tree values
|
n/a
|
n/a
|
N
|
N
|
|
IDField
|
Field that uniquely identifies a tree node
|
n/a
|
n/a
|
N
|
N
|
|
ParentIDField
|
Field that uniquely identifies the parent of a tree node
|
n/a
|
n/a
|
N
|
N
|
|
RootParentID
|
The ID of the node above the tree’s root. Root directories on Remote Things will report their parent as / (forward slash). Set to / to display directories of Remote Things.
|
STRING
|
n/a
|
N
|
N
|
|
TreeFormatter
|
Style formatting rules for tree item labels
|
n/a
|
n/a
|
N
|
N
|
|
ClosedNodeFormatter
|
Style formatting rules for closed tree item images
|
n/a
|
n/a
|
N
|
N
|
|
OpenNodeFormatter
|
Style formatting rules for open tree item images
|
n/a
|
n/a
|
N
|
N
|
|
NoChildFormatter
|
Style formatting rules for tree item images without child items
|
n/a
|
n/a
|
N
|
N
|
|
SelectedLabel
|
The currently selected label
|
STRING
|
n/a
|
Y
|
N
|
|
SelectedValue
|
The currently selected value
|
STRING
|
n/a
|
Y
|
N
|
|
SelectedBreadcrumb
|
The currently selected breadcrumb. The default value is shown before a node in the tree is selected.
|
STRING
|
n/a
|
Y
|
N
|
|
Data
|
Bindable data source
|
INFOTABLE
|
n/a
|
Y
|
N
|
|
CollapseChildrenOfLevel
|
A numeric value. The defined value determines the level of the tree that is collapsed on the initial load. Set to 1 to have a completely collapsed tree upon initial load.
|
NUMBER
|
99
|
N
|
N
|
|
DoubleClicked
|
Triggers an event when you double click the widget.
|
n/a
|
n/a
|
Y
|
N
|
 |
Make sure that you enter only string values in the STRING input fields. In the STRING input fields, the Tree widget does not support values that are entered in HTML tags. Due to security enhancements, the string values entered in HTML tags are not rendered at run time and the data does not appear.
|
|
|
You must not enter an id 0/0 for any node in the Tree widget. This is a known limitation with the Dhtmlx library as the library uses the id 0/0 for the root of the tree, and you cannot use this id for any other nodes.
|