Specifies the menu on which the tree is based.

You can enter the name of a menu you have created using the Menu Configuration view in the Visualization activity (see Prepare the Navigation Menu).

Alternatively, you can use the name of a menu that is created at runtime using the MenuGetPageNode Cicode function.

You can also enter "__EquipmentModel" to use the equipment hierarchy defined for the current project.

The height of the area the tree view will occupy (in pixels).

If the length of the expanded tree extends beyond the height specified here, a vertical scroll bar will appear.

The width of the area the tree view will occupy (in pixels).

If the width of the expanded tree extends beyond the left edge of the alarm count list, a horizontal scroll bar will appear.

The amount of space that will be available to each row within the tree view.

Determines if a check box is displayed for each item in the tree.

TRUE = Check boxes are displayed.

FALSE = Check boxes are not displayed.

Determines if the check boxes within the lower levels of a branch are automatically checked when a parent item is checked.

TRUE = Children are automatically checked.

FALSE = Children are not automatically checked.

Determines if alarm counts for the top three alarm categories are displayed for each item in the tree.

If the branch is collapsed, the values will represent the number of active alarms for each category within the current branch and its lower levels.

If a node is expanded, the count will only shows alarms for that node, as the counts for its children will now be visible on the child nodes.

TRUE = Alarm counts for the top three alarm categories are displayed.

FALSE = Alarm counts for the top three alarm categories are not displayed.

Represents the name of the function that is invoked when the tree view completes initialization.

OnInitCompleteFunction(INT nTreeviewAN)

The argument nTreeviewAN is expected, it is the animation number of the tree view that fires the event.

Represents the name of the function that is invoked upon the checked event.

OnCheckFunction(INT hMenuItem)

The argument hMenuItem is expected. It is the handle to the menu item that is represented by the tree node on which the check box has just been clicked.

Represents the name of the function that is invoked upon the left click event.

OnLeftClickFunction(INT hMenuItem)

The argument hMenuItem is expected. It is the handle to the menu item that is represented by the tree node that has just been left-clicked.

Refers to the Genie that is called to display each item in the tree. By default, the Tree View Item Genie in the "sa_controls" library is used (sa_controls.treeviewitem).

The Cicode function that is called to initialize the View Genie (see above) for each row.

By default, a system function called "_Treeview_InitViewGenie_<resolution>" is used (for example, "_Treeview_InitViewGenie_HD1080").

This function is called on each page scan to manage data updates in the tree view when the tree view state changes (for example, when scrolling, expanding, or collapsing occurs).

By default, a system function called "_Treeview_Update" is used.

Specifies the number of custom fields per tree view item to be allocated for user data. The data in these fields will be updated by the function specified in the parameter Datasource Item Retrieve Function (see below).

This parameter is set to zero (0) by default.

Custom function to configure the additional columns specified by the parameter 'View Model Data Size'. This function is called once when the tree view is initialized.

A custom function that loads additional user data for the tree view. This function is called whenever the tree view data is refreshed (for example, when scrolling, expanding, or collapsing occurs). The number of custom fields to be updated by this function is defined by the parameter View Model Data Size (see above).

Enter the name a function that is used to determine if the data source is ready.

The tree view initialization code will run the function (in addition to the checks for navigation initialized and workspace system initialized) before allowing the tree view to be displayed.

If this function does not return TRUE within five seconds of displaying the page, the tree view initialization will time out. This function needs to return an INT (TRUE or FALSE) and takes a single argument, INT nTreeviewAN.

Enter a Cicode function that will be used to monitor the tree view's associated data source for any updates. The function will be called when the Tree View Genie is initialized, and needs to be responsible for triggering a reload if required.

The function will run continuously, so it should not return any values. It also needs to accept the arguments sDatasource and hTreeviewAN.

If you are using the Tree View Genie to display the entire equipment model (for example, if the Datasource parameter is set to "__EquipmentModel"), you can enter the following function name to trigger a reload of the tree whenever the equipment model changes:

_Treeview_MonitorEquipmentModel