TitleBarApp properties

Primary Font Family

Option to specify the font family for text shown on the primary row of a title bar. Roboto is the default font.

Primary Font Size

Point size of text shown on the first row of a title bar. 14 points is the default font size.

Has Secondary Row

Option to include or exclude a secondary title bar row immediately beneath the primary row. The default is to include a secondary title bar row.

Note:

Has Secondary Row must be selected to show the two Secondary Font properties listed below.

Secondary Font Family

Option to specify the font family for text shown on the secondary row of a title bar. Roboto is the default font.

Secondary Font Size

Point size of text shown on the secondary row of a title bar. 10 points is the default font size.

Background

Color of the TitleBarApp background shown in the pane of a running ViewApp. Select the Background field to show a small triangle at the right. Select the triangle to show a color picker to set the background color. Black or #FF000000 is default background color.

Foreground

Color of the TitleBarApp foreground shown in the pane of a running ViewApp. Select the Foreground field to show a small triangle at the right. Select the triangle to show a color picker to set the foreground color. White or #FFFFFFFF is the default foreground color.

Title

Static text string to include on a title bar. AVEVA OMI is the default title.

Home

Shows a Home button, which the user selects to set the focus of the ViewApp to the root of the ViewApp navigation model. The default is to show the Home icon.

The property includes a drop-down list to select the location within a title bar to place the Home button. SecondaryLeft is the default location of the Home icon.

Navigation Title

Shows the title of the current selected navigation item. The default is to show the Navigation Title.

The property includes a drop-down list to select the location within a title bar to place the Navigation Title. SecondaryLeft is the default location.

Keyboard

Shows a keyboard button, which the user selects to show an on-screen keyboard within a pop-up window. The default is to show the Keyboard icon.

The property includes a drop-down list to select the location within a title bar to place the Keyboard button. PrimaryRight is the default location.

Based on a retentive attribute setting in the MyViewApp.ViewApp namespace, you can show a standard Windows keyboard (default) or the built-in AVEVA OMI keyboard. See ViewApp Namespace Attributes in the AVEVA OMI SDK Help for more information.

Login

Shows an optional Login button, which the user selects to show a log in dialog box to enter a username and password. The default is to show the Login button.

When a user logs in to a ViewApp, the Login button and drop arrow are shown. Pressing the button automatically logs out the current user from the ViewApp. Pressing the drop arrow shows options “Login” and “Logout”. The “Login” option enables a different user to log in to the ViewApp.

The default position of the Login button on a title bar is PrimaryRight.

Language

Shows an optional Language button, which the user can select to show a list of languages configured for the ViewApp. The current language is the caption of the Language button. Selecting another language from the list changes the language used by the running ViewApp. The default is None to hide the Language button.

The property includes a drop-down list to select the location within a title bar to place the Language button.

Date

Shows the current date formatted as MM/DD/YYYY. The default is None to hide the Date value.

Time

Shows the current time formatted as HH:MM AM/PM. The default is None to hide the Time value.

Date and Time

Shows the current date and time formatted as MM/DD/YYYY HH:MM AM/PM.

The property includes a drop-down list to select the location within a title bar to place the date and time. SecondaryRight is the default location.

Show Minimize

Inserts a Minimize icon on the title bar that minimizes a running ViewApp window to an item on the window's task bar when selected. The default is to show the Minimize icon.

Show Maximize

Inserts a Maximize icon on the title bar that maximizes a running ViewApp window to full screen size when selected. The default is to show a Maximize icon.

The Maximize icon changes to a Restore Down icon on the title bar after the ViewApp window has been maximized. Selecting the Restore Down icon restores the ViewApp window to its previous size before it was maximized.

Show Close Layout

Inserts a Close Layout icon on the title bar, which closes the current layout running in a ViewApp window when selected. The default is to show the Close Layout icon.

Show Close ViewApp

Inserts a Close ViewApp icon on the title bar that closes an entire running ViewApp when selected. The default is to hide the Show Close ViewApp icon.

Available Events

Lists all available events of the TitleBarControl from a list that appears by double-clicking on the data entry field. Select one or more events from the list to create event handlers that can be used in scripting.For more information about event handler scripts, see Write an event handler script.