Config.ini [SYSTEM] Section Variables for the Display Manager

The following list of variables belonging to the Config.ini configuration file's [SYSTEM] section pertain to the Display Manager.

Quick note:  If you want your application to be inside a standard Windows window, (i.e. a resizable window with a title bar and control buttons) use the following settings:

DispMgrResizable = 1

DispMgrFullScreen = 0

DispMgrMinMaxDisabled = 0

 

DefaultBGColor 

Indicates the background color when no page is displayed in the Display Manager. By default, the background color to be displayed is black (0). For valid color values, please refer to Reserved Color Values.

Default: DefaultBGColor = 0

DefaultPageColor

Indicates the background color for new pages. By default, the page background color to be displayed for VTS applications is white (15), while the default background color to be displayed for VTScada applications is black (0). For valid color values, please refer to Reserved Color Values.

Default DefaultPageColor = 15 OR (VTScada) DefaultPageColor = 0

DisplayManagerTitle

Indicates the title to be displayed in the center of the Display Manager's title bar.

DispMgrBitmap

Indicates the bitmap to be displayed on the left side of the Display Manager's title bar. For VTS applications, this bitmap is the VTS orb logo (named, "VTS38.bmp"). This logo is stored in the VTS product or installation directory. For VTScada applications, this bitmap is the VTScada logo (named, "VTScada.bmp"). This logo is stored in the VTScada layer directory (e.g. C:\VTS\VTScada\).

If you wish to replace either the VTS or VTScada title bar logo, store your custom logo within your application directory, and reference it using a relative path (e.g. "DispMgrBitmap = MyCustomLogo.bmp".

Default: DispMgrBitmap = VTS38.bmp OR DispMgrBitmap = VTScada.bmp

DispMgrBMPMarginLeft

Indicates the width of the left margin for the background bitmap

DispMgrBMPMarginBottom

Indicates the width of the bottom margin for the background bitmap

DispMgrBMPMarginRight

Indicates the width of the right margin for the background bitmap

DispMgrBMPMarginTop

Indicates the width of the top margin for the background bitmap, if margins are enabled

DispMgrBMPMarginsWin

Enables background bitmap margins for windowed pages

DispMgrHeight

Indicates the height (vertical) of the Display Manager. If set to invalid (which it is by default), DispMgrHeight uses the VStatus(Self(),27) call to determine the default height of the Display Manager based on the video board and screen characteristics of your workstation.

Related Variables: To set the width of the Display Manager, use the DispMgrWidth variable.

Default: DispMgrHeight =

DispMgrHoriz

Enables you to set the Display Manager to tile multiple pages on the screen. DispMgrHoriz indicates the number of pages to display horizontally.

Related Variables: Both the DispMgrHoriz and the DispMgrVert variables must be set in order for the Display Manager to tile multiple windows; setting only one of these variables will have no effect.

Default: DispMgrHoriz = 1

DispMgrFullScreen

Enables you to specify whether the Display Manager should feature a Windows title bar with a title and close buttons. (The additional presence of minimize and maximize buttons is determined by the setting of the DispMgrMinMaxDisabled variable.)

If set to 0 (false), the Display Manager does not display in full screen mode, and has a windows title bar with a default title of "Display" and a close button. (To modify the title displayed in the Windows title bar, use the DisplayManagerTitle variable in the [LABELS] section of Config.ini.)

If set to 1 (true), the Display Manager displays in full screen mode. No Windows title bar is present (default).

Default: DispMgrFullScreen = 1

DispMgrMinMaxDisabled

Enables you to control the presence of minimize and maximize buttons in the Windows title bar of the Display Manager if the DispMgrFullScreen variable is set to 0 (indicating that a Windows title bar is present for the Display Manager).

If set to 0 (false), the minimize or maximize buttons are present in the Windows title bar (if a Windows title bar has been configured for this application using the DispMgrFullScreen variable) (default).

If set to 1 (true), minimize and maximize buttons are not present in the Windows title bar (if a Windows title bar has been configured for this application using the DispMgrFullScreen variable).

Default: DispMgrMinMaxDisabled = 0

DispMgrPageStyle

Normally configured via the 'Page Style' tab of the RealmDisplaySetup tag. This variable allows you to control the page style characteristics of a full screen VTS Internet Client page.  This is a bitwise variable with the following meanings for the bits:

 

Value

Meaning

0x0001

Show Title Bar

0x0002

Show Title Bar Bitmap

0x0004

Show Title Bar Logon Button

0x0008

Show Title Bar Configure Button

0x0010

Show Title Bar Date & Time

0x0020

Show Title Bar Alarm indicators

0x00FF

Show all Title Bar decorations

0x0100

Show Task Bar

0x0200

Show Menu Button and Menu

0x0400

Show Task bar Page buttons

0x0800

Show Task bar "<" and ">" buttons

0x1000

Show Task bar "+" and "-" buttons

0x2000

Hold page btn changes target

0xFF00

Show all Menu Bar decorations

Default: DispMgrPageStyle = 0xFFFF

DispMgrResizable

Enables you to indicate whether or not the Display Manager should be horizontally and vertically resizable by dragging the window's borders when in windowed mode (i.e. when the DispMgrFullScreen variable is set to 0).

If set to 0 (false), the Display Manager will not be resizable by dragging its borders horizontally or vertically (if a Windows title bar has been configured for this application by setting the DispMgrFullScreen variable to 0) (default).

If set to 1 (true), the Display Manager will be resizable by dragging its borders horizontally or vertically (if a Windows title bar has been configured for this application by setting the DispMgrFullScreen variable to 0).

Related Variables: The DispMgrFullScreen variable must be set to 0 (i.e. the Display Manager must be configured to display a Windows title bar) in order for DispMgrResizable to take effect. The DispMgrHeight, DispMgrWidth, BrowserHeight, and BrowserWidth variables will apply to the Display Manager only until the window has been resized by dragging its borders, after which the Display Manager will retain the newly adjusted size. If DispMgrMinMaxDisabled is set to 1, the Display Manager will not feature Windows minimum and maximize buttons, however, the window will be resizable by dragging its borders.

Default: DispMgrResizable = 0

DispMgrTimeFormat

Indicates the format of the time displayed in the Display Manager's upper right corner. The default format for the time is "hr:mm HH" (for example. "1:38 AM"). The available time formats are the same as those for the Time function.

Default: DispMgrTimeFormat = 7

DispMgrTitleBorder

When set to 0, disables the title bar and borders.  When set to 1 or when missing altogether, the title bar and borders are unaffected.

Default: DispMgrTitleBorder = 1

DispMgrVert

Enables you to set the Display Manager to tile multiple pages on the screen. DispMgrVert indicates the number of pages to display vertically.

Related Variables: Both the DispMgrVert and the DispMgrHoriz variables must be set in order for the Display Manager to tile multiple windows; setting only one of these two variables will have no effect.

Default: DispMgrVert = 1

DispMgrWidth

Indicates the width (horizontal) of the Display Manager. If set to invalid (which it is by default), DispMgrWidth uses the VStatus(Self(), 26) call to determine the default width of the Display Manager based on the video board and screen characteristics of your workstation.

Related Variables: To set the height of the Display Manager, use the DispMgrHeight variable.

Default: DispMgrWidth =

DispMgrWPageStyle

Normally configured via the 'Windowsed Page Style' tab of the RealmDisplaySetup tag. This variable allows you to control the page style characteristics of a windowed VTS Internet Client page.  This is a bitwise variable with the following meanings for the bits:

 

Value

Meaning

0x0001

Show Title Bar

0x0002

Show Title Bar Bitmap

0x0004

Show Title Bar Logon Button

0x0008

Show Title Bar Configure Button

0x0010

Show Title Bar Date & Time

0x0020

Show Title Bar Alarm indicators

0x00FF

Show all Title Bar decorations

0x0100

Show Task Bar

0x0200

Show Menu Button and Menu

0x0400

Show Task bar Page buttons

0x0800

Show Task bar "<" and ">" buttons

0x1000

Show Task bar "+" and "-" buttons

0x2000

Hold page btn changes target

0xFF00

Show all Menu Bar decorations

Default: DispMgrWPageStyle = 0xFFFF

DispMgrX

Indicates the X coordinate (horizontal) of the Display Manager's upper left corner if the Display Manager is not in full screen mode.

Related Variables: To set the Y coordinate of the Display Manager's upper left corner, use the DispMgrY variable. To set the height of the Display Manager, use the DispMgrHeight and DispMgrWidth variables.

By default, the Display Manager is in full screen mode. This behaviour can be controlled using the DispMgrFullScreen variable.

Default: DispMgrX = 0

DispMgrY

Indicates the Y coordinate (vertical) of the Display Manager's upper left corner if the Display Manager is not in full screen mode.

Related Variables: To set the X coordinate of the Display Manager's upper left corner, use the DispMgrX variable. To set the height of the Display Manager, use the DispMgrHeight and DispMgrWidth variables.

By default, the Display Manager is in full screen mode. This behaviour can be controlled using the DispMgrFullScreen variable.

Default: DispMgrY = 0

Page Indicates the page file name of the first page to be opened in the Display Manager when the application runs.

If set to invalid (as it is by default), the Display Manager displays the last page that was viewed before the application was stopped.

Default: Page =

ScaleDisplayContent

Indicates whether the contents of the pages shown in the Display Manager should be stretched and/or shrunk to fit within the Display Manager's display area.

If set to 0 (false), then the contents of the pages shown in the Display Manager are not stretched and/or shrunk to fit within the Display Manager's display area (default).

If set to 1 (true), then the contents of the pages shown in the Display Manager are stretched and/or shrunk to fit within the Display Manager's display area.

Default: ScaleDisplayContent = 0

ToolBoxTranslucent

Indicates whether or not you wish the Configuration Toolbox to be translucent when any of the configuration tools (e.g. Tag Browser, Menu Editor, etc.) are open.

If set to 0, then the Configuration Toolbox will not be translucent when any of the configuration tools are open.

If set to 1 (default), the Configuration Toolbox will be translucent when any of the configuration tools are open.

Default: ToolBoxTranslucent = 1