The Page property is used to give a name to the menu that will include the item.

In a Situational Awareness project, the system expects the following menu names:

• InformationZone – used to define the tabs that appear across the Information Zone on the operator dashboard.
• Headerbar – used to define the content of the workspace header bar.
• Navigation – used to define the layout of buttons and tabs on the Navigation Zone on the operator dashboard.

A project based on the Situational Awareness Starter Project will include a set of default entries for the InformationZone and Headerbar menus.

There are no default entries for the Navigation menu, as you will need to manually configure these to reflect the pages included in your project. See Prepare Navigation Menus.

In a Situational Awareness project, the Level 1-6 properties are used in the following ways, based on the three expected menus:

• InformationZone – this menu defines the tabs that appear across the Information Zone. Only a single sets of tabs is supported, which means only the Level 1 field is used.
• Headerbar – this menu defines the content of the workspace header bar. The included buttons are specified by the Level 1 field. The default "Login Menu" uses Level 2 to add a "Log Out" option as a drop-down menu.
• Navigation – this menu defines the layout of buttons and tabs on the Navigation Zone on the operator dashboard. Level 1 of the menu sets the overall context for the workspace. The tabs along the navigation section header represent the menu's Level 2 entries. The buttons on each tab represent up to 20 lower-level menu entries.

In each case, the arrangement of menu entries is determined by the Order property.

The Cicode expression to be executed when the menu item is selected. String of up to 254 characters.

For Situational Awareness projects, use the "Navigation_ShowTargetPage" command to call a page.

If you have the same page in HD1080 and UHD4K resolutions (to support a range of client screens), the variation of the page that displays at runtime will be determined by the context of the current workspace. This means you do not need to add the resolution suffix ("_HD1080" or "_UHD4K") to the end of the page name specified in the Target Page field.

The page that is displayed when the menu item is executed. See the Menu Command property.

An optional comment (of up to 128 characters) about the menu entry.

Defines the position of a menu entry in relation to the other menu entries in the same hierarchy level. The Order property functions in the following ways, based on the three expected menus:

• InformationZone – the order defines how the tabs will appear across the top of Information Zone (from left to right).
• Headerbar – the order defines how the command buttons will appear across the workspace header bar (from left to right).
• Navigation – For Level 1 entries, the order defines how the tabs will appear across the top of Navigation Zone (from left to right). For lower level entries, the order determines the layout of up to 20 buttons on each tab (four rows of five buttons, from left to right).

If this field is left blank, it will take the default value of zero (0). If more than one entry of the same order exists, they are displayed in the same order as they are defined in the database. In the case of Navigation menu, the entry will fill the first available space in the layout of buttons.

This property affects the order that the menu entries are returned through menu Cicode functions.

A Cicode expression that determines when the menu entry is hidden on the page.

A Cicode expression that determine when the menu entry is disabled on the page.

A number to indicate how the disabled entry is displayed in the menu. It is up to the user to decide what the numbers mean.

Note: By default, this property is not used by a Situational Awareness project.

If the menu entry is associated with a tab, this field allows you to display an icon on the tab. Enter the name of the graphic file you would like to display. You can use the Custom 2 property (see below) to hide the symbol if required.

The user privilege (0–8) that is necessary to select the menu entry.

The user area (0–255) that is necessary to select the menu entry.

If the menu entry is associated with a tab, this field allows you to specify if the 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.

The name of the cluster associated with the menu item. The specified cluster should be configured otherwise a compile will not be successful.

If the menu entry is associated with a tab, this 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.

If the menu entry is associated with a tab, this 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. .

If the menu entry is associated with a tab, this 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.

The page on which this entry will exist. If blank, the entry exists on every page.

Creates the menu hierarchy path of the entry. String length can be up to 64 characters.

Up to 6 levels of menu hierarchy are supported. Menu entries that have the same upper levels are considered to be under the same hierarchical branch.

Note: Menu entries are not case sensitive.

The Cicode expression to be executed when the menu item is selected. String of up to 254 characters.

A comment about the menu entry. String of up to 128 characters.

The position of a menu entry in relation to the other menu entries in the same hierarchy level.

This property affects the order that the menu entries are returned through the menu Cicode functions. If this field is left blank, it will take the default value of zero (0). The relevant menu entries will be returned at the start as a result. If more than one entry of the same order exists, they are displayed in the same order as they are defined in the database.

The symbol to associate with the menu entry. The string length can be up to 128 characters. A symbol needs to be already defined in the project / included project, and specified in the format of <library name>.<symbol name>.

Cicode expression to determine when the menu entry is hidden on the page. String of up to 254 characters.

Cicode expression to determine when the menu entry is disabled on the page. String of up to 254 characters.

A number to indicate how the disabled entry is displayed in the menu. It is up to the user to decide what the numbers mean.

The width of the menu entry on the page. It is up to the user to decide what units to be used.

Determines if the menu entry is initialized with a checked status.

The user privilege of (0-8) necessary to select the menu entry.

The name of the cluster associated with the menu item. The specified cluster should be configured otherwise a compile will not be successful.

The page on which this entry will exist. If blank, the entry exists every page.

The page name of "Template" is a keyword used in the Tab Style templates for defining custom pop-up menus.

Creates the menu hierarchy path of the entry. String length can be up to 64 characters.

Up to 6 levels of menu hierarchy are supported. Menu entries that have the same upper levels are considered to be under the same hierarchical branch.

Note: Menu entries are not case sensitive.

In a Tab Style Project:

• Level 1 represents the tabs on the tab bar.
• Level 2 represents the buttons displayed under a particular tab.
• Level 3 represents the menu items of the drop-down menu next to a particular button.
• Level 4 represents the sub-menu items of a particular drop-down menu item.

The Cicode expression to be executed when the menu item is selected. String of up to 254 characters.

A comment about the menu entry. String of up to 128 characters.

The relative display position of the tabs/buttons or menu items among themselves.

For the tabs and buttons, it determines the display order from left to right. For the drop-down menu items, it determines the display order from the top to the bottom.

If this field is left blank, it will take the default value of 0. The relevant entries will be displayed at the start as a result.

If more than one entry of the same order exists, they are displayed in the same order as they are defined in the database.

The symbol to associate with the menu entry. The string length can be up to 128 characters. The format to use is <library name>.<symbol name>.

The template expects the symbol to be a certain size when it is configured against different menu types.

• For tabs, symbols are 16 x 16 pixels.
• For buttons, symbols are 32 x 32 pixels.

Some common symbols can be found in the symbol libraries "icons_16x16" and "icons_32x32".

The field is not applicable for menu and sub-menu items.

The tab menu bar on the template does not support visibility. When the expression defined in this field is true, the relevant menu entry is disabled instead.

Cicode expression to determine when the menu entry is disabled on the page. String of up to 254 characters.

This field is not used by the tab menu bar on the template.

The width (measured in pixels) of the item on the page. If this is not specified, the item is automatically sized to show the most content. This field only applies to the tabs and buttons.

The objects used in the template are subjected to minimum widths:

• Tab (Level 1) = 63 pixels.
• Button(Level 2) = 61 pixels.

Determines if the menu entry is initialized with a checked status. This field only applies to the menu items and sub-menu items.

The user privilege of (0-8) necessary to select the menu entry.

The name of the cluster associated with the menu item. The specified cluster should be configured otherwise a compile will not be successful.