ProjectNavigationTextual
The ProjectNavigationTextual is one of the generic controls and can be used to navigate through the entire project structure of a device. It shows the type, description, value and events of the objects.
 | Here you will find more detailed information about the generic possibilities of TcHmiBa and how they can be used. |
Use
To be able to navigate through the complete project structure of a runtime, it must be linked with the attribute BaObject. Furthermore, the control allows you to navigate through the children of any view. If only a single object (that is, no view) is linked, then only one entry is displayed with this object.
Features
Generic navigation
The navigation is configured generically based on the structure of the linked object / view. Thus it is possible to reach all objects with only one binding. For each object, the type (e.g. Analog Input, Structured View), the description, a value (if available) and the events are displayed.
Manual override
The display of the value and the override with a manual value is realized by using the ManualOverride control.
Navigation to content page
Sometimes it may be necessary to navigate directly to the content page of a system from the project navigation. This can be configured by assigning the SymbolPath of the system's view as the name of the content page to be navigated to.
Sample:
The content page of the heating circuit must therefore be named TF8040_Tutorial_04_PLC_MAIN.H.HTC01.content .
After that, there is an arrow at the end of the line of the heating circuit in the project navigation. Selecting this arrow will navigate to the corresponding content page:
Header menu
The button in the header opens a menu in which:
- the label to be displayed for the entries can be selected.
- the trend configurator can be opened and the generated trend configurations can be displayed.
The search field allows you to filter the list by a specific term.
Parameter window
The object type is identified by the icon of the button at the start of an entry. Pressing this button opens the parameter window of this object.
The content of this window differs, depending on the selected object. First, all parameters of the respective object are displayed. In the image above, a view is selected that has fewer parameters than an analog input, for example. Which parameters are displayed and which are writable or read-only depends on the rights of the logged-in user.
The changed parameters are written to the PLC when the dialog is closed via the Confirm button. When you click the Close button, the settings you have made will be lost.
Depending on the selected object, the header shows one or two additional buttons.
The button with the event bell is available for every event-enabled object and replaces the contents of the window with the event list of the object when clicked.
The second button is intended for various Trend functionalities and is available only for objects that support them or for views that contain objects with trend functions.
Attributes
The control inherits from BaseControl and thus has the same attributes. In addition, there are the following attributes.
BA
BaObject
tchmi:framework#/definitions/Symbol
To use the generic functionalities of TcHmiBa. It links a single object or a complete view (including children) to the control.
| You can find more detailed information about the generic possibilities of TcHmiBa under Generic HMI. |
Common
BaUsedTitle
tchmi:framework#/definitions/TcHmi.BuildingAutomation.Controls.ProjectNavigationTextual.BaUsedTitle
Determines which parameter is used for the description in an entry. The setting can be customized in the client.
Show header
tchmi:general#/definitions/Boolean
Determines whether the header is displayed or not.