Common Navigation Functionality
- Last UpdatedJul 18, 2023
- 6 minute read
The tab style page templates include common toolbars for easy navigation and feature access, as well as a consistent appearance. This helps ensure pages that are created based on these templates will look and operate in the same style.
The following three toolbars remain on screen during operation:
Custom tabbed menus toolbar
The tab style templates provide a tabbed toolbar to present the custom menus defined in the menu configuration database. The tabbed menu toolbar consists of following components:
-
Tab Buttons
Tab buttons are equivalent of selecting a menu option in a traditional menu system. Each tab contains a list of menu items (represented as icons) relating to that tab.
-
Menu Icons (Buttons)
Each tab contains a row of menu icons, each of which either performs a function such as calling up a page or running a Cicode expression.
-
Sub-menu Drop Down Lists
Optionally, a drop-down list may be provided next to the menu icon for further options. You can also view it as a sub-menu to the top-level tab. In this case, the menu icon serves as a collection point for related sub-menu items.
-
Hidden Menu Items
Where there are too many menu items to fit comfortably within the menu bar (either for the tabs or the menu icons), a pair of drop-down list buttons are supplied at either end of the menu bar which provide access to the menu items. The horizontal arrow buttons on the menu bar displays only those items not visible on either side of the screen. The vertical arrow button on the left side of the menu bar displays menu items (either tabs or the menu icons for the currently selected tab).
Navigation toolbar
The Navigation toolbar includes clickable text and icons to quickly access the common pages and functions from every page in the project.
The following items are available from the toolbar:
|
Icon |
Name |
Description |
|---|---|---|
|
|
Goes back one page in the page history |
Goes back to the page displayed before the current page. |
|
|
Goes forward one page in the page history |
Goes forward to the page that was displayed prior to the back button being pressed. The arrow to the right of the button allows you to select from menu of recently visited pages. |
|
|
Displays the parent page |
Changes the display to the "parent page" of the current page. You can assign a parent page to a graphics page by setting an environment variable in Graphics Builder. To do this, open the page you want to assign a parent to. Go to the properties dialog for the page (File | Properties), and click the Environment tab. Add a new variable called "ParentPage" with a value of the page name of the parent page. |
|
|
Displays the previous page |
Moves backwards through pages in a browse sequence if a sequence is configured. To configure a browse sequence, go to the Page Properties dialog (File | Properties) for each page in the sequence and set the Previous field on the General tab accordingly. |
|
|
Displays the next page |
Moves forwards through pages in a browse sequence if a sequence is configured. To configure a browse sequence, go to the Page Properties dialog (File | Properties) for each page in the sequence and set the Next field on the General tab accordingly. |
|
|
Displays the home page |
Displays the "home" page. A home page act as a default page for the project. To set a home page, use the [Page]HomePage parameter. |
|
|
Displays the Page Select dialog |
Displays a dialog box with a list of graphics pages defined in the project. The user can select a page name for display. |
|
|
Prints the current page |
Prints the current graphic page to the selected printer using the built-in WinPrint() Cicode function. You can specify your own printing function for the page by setting an environment variable in Graphics Builder. To do this, open the page you want to assign a printer function to. Go to the properties dialog for the page (File | Properties), and click the Environment tab. Add a new variable called "PrintPage" with a value of Cicode command in the syntax of "?" followed by a valid Cicode function name and comma separated arguments, for example, ?MyPrintFunction "arg1","arg2". |
|
|
Login / Logout |
Displays the standard Plant SCADA login prompt. The menu to the right offers extra options. The default options are Login, Logout, Change Password, Edit User (restricted by login) and Create User (restricted by login). Logged in user is indicated to the right of the button. You can override the default options by defining your own login menu in the Visualization activityCommand Bar option menu configuration. The Page field and Level 1 field of these menu items needs to be set to "Template" and "Login" respectively. |
Alarm toolbar
The alarms toolbar provides access to current alarm information and navigation buttons for single-click access to alarm pages. It also includes standard Plant SCADA prompt and current date and time.
The alarms toolbar contains the following features:
|
Icon |
Name |
Description |
|---|---|---|
|
n/a |
Last Alarms |
The center panel of the toolbar displays the last alarms triggered within the system, providing the operator with an immediate visual cue to alarm occurrences. You can modify the format of this list and control which alarms appear. For example, you can set the list to only display alarms of a particular type, category or priority. For details, see the alarm parameters LastAlarmFmt, LastAlarmCategories, LastAlarmPriorities, and LastAlarmType . |
|
|
Active Alarms |
Changes the display to the active alarms page. This button is animated and shows the count of unacknowledged alarms in the system. The page displayed by this button is determined by the parameter [Page]AlarmPage. |
|
|
Historical Events |
The arrow to the right allows you to change the display to the sequence of events
or alarm summary page. When clicking on the historical events button again the sequence
of events page will display by default.However, if there is no SOE page configured
in the project, the alarm summary page will be displayed. This page is determined by the [Page]SOEPage. Alarm Summary - The alarm summary page provides an historical log of alarm occurrences. This page is determined by the [Page]SummaryPage. |
|
|
Hardware Alarms |
Changes the display to the hardware alarms page. This is an animated button which will blink when an unacknowledged hardware alarm occurs. The page displayed by this button is determined by the parameter [Page]HardwarePage. |
|
|
Disabled Alarms |
Changes the display to the disabled alarms page. This button shows the count of disabled alarms in the system. The page displayed by this button is determined by the parameter [Page]DisabledPage. |
|
|
Alarm Silence |
Silences the audible alarm buzzer that sounds when there are pending unacknowledged alarms. See Implement Audible Alarms. |













