Create a Set of Tabs for a Pane
- Last UpdatedJul 13, 2023
- 4 minute read
You can use the Tab Bar Genie to create a set of tabs for a pane, just like those displayed in the Information Zone on the Situational Awareness dashboard.

If the available space cannot accommodate the configured tabs, you can access those that are not displayed via the drop-down menu to the right of the tabs. You can also enable "pinning", which allows an operator to specify that a particular tab remains displayed.
To configure a set of tabs, you need to perform the tasks described below.
Create a menu
The Tab Bar Genie calls a menu defined in a project's Menu Configuration database. You will need to create an appropriate menu in Plant SCADA Studio's Visualization activity (see Menu Configuration).
In the case of a menu created for a set of tabs, use the following fields:
-
The Page property is used to give the tabbed menu a name.
-
The Level 1 entries define the tabs that appear.
-
The Target Page property determines what will be displayed in the content pane when a tab is selected.
You can also customize the tabs using the following properties:
-
The Symbol property allows you to you to display a lock icon on the tab. Enter any value if you want the lock to display. You can use the Custom 2 property (see below) to hide the icon if required.
-
The Checked property allows you to specify if a tab is pinned by default. Leaving the field blank will mean the tab is not pinned by default. Any other value will mean the tab is pinned by default. This setting will only work if pinning is enabled for the tab bar. This is determined by the Can Tabs Be Pinned? parameter in the Tab Bar Genie (see Configure the tab bar genie below).
-
The Menu Command property can be used to specify a Cicode expression that is executed when the associated tab is selected.
-
The Custom 1 property determines if the Close button will appear on the tab. If you leave this field blank, the Close button will appear. Any other value will hide the Close button.
-
The Custom 2 property determines if the icon identified in the Symbol field will appear on the tab. If you leave this field blank, the icon will appear. Any other value will hide the icon.
-
The Custom 3 property determines if a label will appear on the tab. If you leave this field blank, the label will appear. Any other value will hide the label.
Note: The Custom 4 – Custom 8 fields are reserved for system use.
Create the host panes
Two adjacent panes are required to support a set of tabs:
-
Header pane - hosts a page with the Tab Bar Genie on it
-
Content pane - displays the target page that is associated with a selected tab.
The two are linked with each other via the Pane Properties for the content pane. The following Tabbed Pane Properties are used:
-
Header Pane Name — identifies the associated header pane
-
Tab Control Name — identifies the Tab Bar Genie in the header pane that determines what the content pane will display.
Create the required pages
You need to create the following pages:
-
Header page — you need an appropriately sized page that will occupy the header pane and host the Tab Bar Genie.
-
Content pages — you need appropriately sized pages for each item specified in the menu you created. The page names need to match those defined in the Target Page field for each menu entry.
Configure the Tab Bar Genie
Lastly, you need to configure the Tab Bar Genie parameters. To display the Genie Parameters dialog box, double-click on the Genie, or select Genie Parameters from the right-click menu. Make the required adjustments to the following fields.
|
Parameter |
Description |
|---|---|
|
Default Tabs Menu Name |
Enter the name of the menu you configured to define the tabs that will display. |
|
OnInit Function Name |
If required, specify a Cicode function that is executed when the tab bar initialization has completed. |
|
Can Tabs be Pinned? |
Specify if an operator can pin a tab so that it remains displayed. TRUE = Pinning is enabled FALSE = Pinning is not enabled. |
|
Max Open Items |
If required, sets a limit on the number of menu items that are included on the tab bar at runtime. The menu items are selected according to the value set for Order property. If the Order property is not configured, items are selected according to the order in which they were added to the Menu Configuration database. |
|
Tab Bar Width |
Specify the width of the tab bar in pixels. |
|
Max Tab Width |
Specify the maximum width for each tab in pixels. |
|
Use for 4K Page? |
Specify if the tab bar will appear on a UHD4K master page. TRUE = The tab bar will be used in a UHD4K project. FALSE = The tab bar will not be used in a UHD4K project. |
|
Allow Duplicate Content? |
Determines if multiple tabs can display the same content. TRUE = Multiple tabs can display the same page. FALSE = Each tab displays a different page (default). For example, you could set this to TRUE if you need two tabs to display the same page, but with a different filter applied. |