|
||
The following properties of the CMSTreeView control can be set or used in the API:
Most of the common properties from:
•CMS controls - common properties
•CMS navigation - common properties
In addition, the following properties are available:
Property Name |
Description |
Sample Value |
DisplayDocumentTypeImages |
If true, the images used for items in the tree will be loaded according to the document type of the given item. |
|
DynamicBehaviour |
If true, populate on demand will be enabled. In this case, sub-items will be loaded dynamically when their parent node is expanded.
This is recommended if there is a large amount of nodes in the tree, or if the content depends on other dynamic parameters. |
|
EncodeMenuCaption |
Indicates whether HTML encoding should be applied to the captions of menu items. Useful only in special cases where the names of the displayed documents contain HTML code. |
|
ExpandAllOnStartup |
Indicates whether all nodes in the tree should be expanded by default. |
|
ExpandCurrentPath |
Indicates whether all nodes along the path to the currently selected item should be expanded by default. |
|
ExpandSubTree |
Indicates whether the sub-tree under the currently selected item should be expanded by default. |
|
FixBrokenLines |
Indicates whether broken lines should be fixed. |
|
HideRootNode |
Indicates whether the root node should be hidden. |
|
HigLightSelectedItem |
Indicates whether the currently selected item should be highlighted. |
|
IgnoreDocumentMenuAction |
Indicates whether the Menu actions document menu settings should be ignored. These can be set in CMS Desk -> Content -> ... select document ... -> Properties -> Navigation -> Menu actions. |
|
InactivateAllItemsInPath |
If enabled, all nodes on the path of the currently selected document will be inactive (will not perform any action when clicked). |
|
InactivateSelectedItem |
If enabled, the node of the currently selected document will be inactive. |
|
InactiveNodeImage |
Indicates if the images displayed next to nodes should also perform the specified action for the given item when clicked. |
|
InactiveRoot |
Indicates whether the root node should be inactive. |
|
NodeImageUrl |
Gets or sets the path to the image that is displayed next to regular nodes in the tree. |
~/App_Themes/Site/Images/treeitem.gif |
OnClickAction |
Gets or sets the JavaScript command that will be executed when a user clicks on an item in the tree. If empty, the items in the tree will serve as links to the corresponding documents. |
|
OrderBy |
Gets or sets the ORDER BY clause of the SQL statement.
Please be aware that it is necessary for the root of the displayed tree (or sub-tree) to be first in the resulting order, otherwise all documents may not be displayed correctly. This can be ensured by having the value of this property start with the NodeLevel column, such as in the sample value. |
"NodeLevel, NodeOrder" |
RootImageUrl |
Gets or sets the path to the image that is displayed next to the root node of the tree. |
~/App_Themes/Site/Images/root.gif |
RootText |
Gets or sets the text caption of the root node in the tree. This text is displayed instead of the document name of the item in the root of the tree. |
As this control is inherited from the ASP.NET TreeView control, it also has all of its standard properties.