Config.ini [SYSTEM] Section Variables for Colors

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

AlarmColor

Designates the color to be flashed to indicate an alarm (e.g. in the Display Manager's title bar). The default color is red (12). For valid color values, please refer to Reserved Color Values.

Default: AlarmColor = 12

ButtonFace

Indicates the background color for buttons.

Note: If left invalid (which it is by default), ButtonFace uses the GetSystemColor(15) function to return the system colors as defined by the user in Windows.

Default: ButtonFace =

ButtonHighlight

Indicates the highlight color for the sides of buttons.

Note: If left invalid (which it is by default), ButtonHighlight uses the GetSystemColor(20) function to return the system colors as defined by the user in Windows.

Default: ButtonHighlight =

ButtonShadow

Indicates the shadow color for the sides of buttons.

Note: If left invalid (which it is by default), ButtonShadow uses the GetSystemColor(16) function to return the system colors as defined by the user in Windows.

Default: ButtonShadow =

ButtonTextColor 

Indicates the color of the text label for buttons.

Note: If left invalid (which it is by default), ButtonTextColor uses the GetSystemColor(18) function to return the system colors as defined by the user in Windows.

Default: ButtonTextColor =

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 is white (15). For valid color values, please refer to Reserved Color Values.

Default DefaultPageColor = 15

DefGraphicBColor

Indicates the default fill color used in the Select Brush color palette, and for all geometric drawing tools featuring a brush or fill color. The default brush color is red. For valid color values, please refer to Reserved Color Values.

Default: DefGraphicBColor = 12

DefGraphicPColor

Indicates the default pen color used in the Select Pen color palette, and for all geometric drawing tools featuring an outline or pen color. The default pen color is black. For valid color values, please refer to Reserved Color Values.

Default: DefGraphicPColor = 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

DialogBGColor

Indicates the background color for dialogs. By default, the background dialog color is obtained from the system using the GetSystemColor(15) function.

Default: DialogBGColor =

FieldHighlight

Indicates the highlight color for the sides of fields.

Note: If left invalid (which it is by default), FieldHighlight uses the GetSystemColor(15) function to return the system colors as defined by the user in Windows.

Default: FieldHighlight =

FieldShadow

Indicates the shadow color for the sides of fields.

Note: If left invalid (which it is by default), FieldShadow uses the GetSystemColor(18) function to return the system colors as defined by the user in Windows.

Default: FieldShadow =

GrayedText

Indicates the color for inactive (disabled) text.

Note: If left invalid (which it is by default), GrayedText uses the GetSystemColor(17) function to return the system colors as defined by the user in Windows.

Default: GrayedText =

GridColor

Indicates the initial color of the Snap Grid. By default, the color is set to light cyan (11). For valid color values, please refer to Reserved Color Values.

Default: GridColor = 11

MenuBgnd

Indicates the background color for the shortcut menu that opens when any graphic object representing a tag is right-clicked. The default setting is invalid, and the default color is derived from system settings.

It is recommended that you choose contrasting colors for the MenuBgnd and MenuTextColor variables so that the text on the shortcut menu is not invisible or difficult to read.

If MenuBgnd is set to invalid (as it is by default), then the background color for the shortcut menu is derived from the GetSystemColor(4) function.

Related Variables: The MenuTextColor (see below), SelectedBgnd, and SelectedText variables (see S Config.ini [SYSTEM] Variables) indicate the colors used for non-selected shortcut menu text, the highlight used for selected shortcut menu text, and the color used for selected shortcut menu text (respectively).

Default: MenuBgnd =

MenuTextColor

Indicates the color of the text used to display the menu items on the shortcut menu that opens when any graphic object representing a tag is right-clicked. The default setting is invalid, and the default color is derived from system settings.

It is recommended that you choose contrasting colors for the MenuBgnd and MenuTextColor variables so that the text on the shortcut menu is not invisible or difficult to read.

If MenuTextColor is set to invalid (as it is by default), then the text color for the shortcut menu is derived from the GetSystemColor(7) function.

Related Variables: The MenuBgnd, SelectedBgnd, and SelectedText variables indicate the colors used for non-selected shortcut menu text, the highlight used for selected shortcut menu text, and the color used for selected shortcut menu text (respectively).

Default: MenuTextColor =

NormalColor

(VTScada) Indicates the color displayed for site symbols, input tags, and in the legend when experiencing normal conditions. The default color is 10 (light green).

Note: The available color values are identified in Reserved Color Values.

Default: NormalColor = 10

OffColor

(VTScada) Specifies the color to be used in the Duplexes drawing method to indicate an off state for digital control and pump status tags. The default color is 10 (light green).

Note: The available color values are identified in Reserved Color Values.

Default: OffColor = 10

OnColor

(VTScada) Specifies the color to be used in the Duplexes drawing method to indicate an on state for digital control and pump status tags. The default color is 12 (light red).

Note: The available color values are identified in Reserved Color Values.

Default: OnColor = 12

OpaqueBackground

Indicates the state of the opacity of background bitmaps (such as maps).

If set to 0 (false), then the background bitmaps are drawn onto the background as transparent backgrounds (default).

If set to 1 (true), then background bitmaps are to be destructively drawn onto the background (opaque).

Note: It is recommended that you set OpaqueBackground to 1 (true) for faster draw times.

Default: OpaqueBackground = 0

PollDisabledColor 

(VTScada) Allows you to modify the color to be used to indicate when polling has been disabled for a station. The default color is purple (13).

Default: PollDisabledColor = 13

ReceiveColor

(VTScada) Specifies the color used to display data received from the I/O devices on the default Communications Data page. The ReceiveColor variable is set to 10 (light green) by default.

Note: By default, the Communications Data page has a black background. If you choose to change the color in which received data is displayed, be sure to choose a color that contrasts well with black.

Note: Please read the information provided for the TransmitColor variable.

Default: ReceiveColor = 10

TipBack

Indicates the background color of tooltips. By default, the background color for tooltips is yellow (14). For valid color values, please refer to Reserved Color Values.

Related Variables: When changing the TipBack variable, take into consideration the text and outline colors set by the TipFore variable (see below), as the background, text, and outline of tooltips must be set in such a way that they can be clearly read.

Another related variable is ShowTip (see Config.ini [SYSTEM] Section Variables for Tooltips) that enables tooltips. If it is set to false (0), then all other tooltip variables are ignored.

Default: TipBack = 14

TipFore

Indicates the foreground (text and outline) color of tooltips. By default, the background of tooltips is black (0).

Related Variables: When changing the TipFore variable, take into consideration the background color set by the TipBack variable (see above), as the background, text, and outline of tooltips must be set in such a way that they can be clearly read.

Another related variable is ShowTip that enables tooltips. If it is set to false (0), then all other tooltip variables are ignored ((see Config.ini [SYSTEM] Section Variables for Tooltips).

Default: TipFore = 0

TransmitColor 

(VTScada) Specifies the color used to display data transmitted to I/O devices on the default Communications Data page. The TransmitColor variable is set to 11 (light cyan) by default.

Note: By default, the Communications Data page has a black background. If you choose to change the color in which transmitted data is displayed, be sure to choose a color that contrasts well with black.

Note: Please read the information provided for the ReceiveColor variable.

Default: TransmitColor = 11

SelectedBGnd 

Indicates the color of the highlight used to indicate that a menu item is selected on the shortcut menu that opens when any graphic object representing a tag is right-clicked. The default setting is invalid, and the default color is derived from system settings.

It is recommended that you choose contrasting colors for the SelectedBgnd and SelectedText variables so that the text on the shortcut menu is not invisible or difficult to read.

If SelectedBgnd is set to invalid (as it is by default), then the text color for the shortcut menu is derived from the GetSystemColor(13) function.

Related Variables: The MenuBgnd, MenuTextColor (see M Config.ini [SYSTEM] Variables), and SelectedText variables indicate the colors used for the background of the shortcut menu, non-selected shortcut menu text, and the color used for selected shortcut menu text (respectively).

Default: SelectedBgnd =

SelectedText

Indicates the color of text when highlighted in the shortcut menu that opens when any graphic object representing a tag is right-clicked. The default setting is invalid, and the default color is derived from system settings.

It is recommended that you choose contrasting colors for the SelectedBgnd and SelectedTextColor variables so that the text on the shortcut menu is not invisible or difficult to read.

If SelectedText is set to invalid (as it is by default), then the color for text highlighted in the shortcut menu is derived from the GetSystemColor(14) function.

Related Variables: The MenuBgnd, MenuTextColor (see M Config.ini [SYSTEM] Variables), and SelectedText variables indicate the colors used for the background of the shortcut menu, non-selected shortcut menu text, and the highlight color used for selected shortcut menu text (respectively).

Default: SelectedText =

State0DefColor 

Indicates the default color for state 0 for drawing methods for digital tags. This setting can be overridden on an individual basis in the tag's drawing method's settings. By default, state 0 is set to be represented by a light red color (12).

Related Variables: The State0DefColor variable should be used together with the State1DefColor, State2DefColor, State3DefColor and InvalidColor variables in order to make the default settings for different states unique and comprehensive.

Default: State0DefColor = 12

State1DefColor 

Indicates the default color for state 1 for drawing methods of digital tags. This variable can be overridden on an individual tag basis in the tag's drawing method's settings. By default, state 1 is set to be represented by a light green color (10).

Related Variables: The State1DefColor variable should be used together with the State0DefColor, State2DefColor, State3DefColor and InvalidColor variables in order to make the default settings for different states unique and comprehensive.

Default: State1DefColor = 10

State2DefColor

Indicates the default color for state 2 for drawing methods of digital tags. This variable can be overridden on an individual tag basis in the tag's drawing method's settings. By default, state 2 is set to be represented by a light cyan color (11).

Related Variables: The State2DefColor variable should be used together with the State0DefColor, State1DefColor, State3DefColor, and InvalidColor variables in order to make the default settings for different states unique and comprehensive.

Default: State2DefColor = 11

State3DefColor

Indicates the default color for state 3 for drawing methods of digital tags. This variable can be overridden on an individual basis in the tag's drawing method's settings. By default, state 3 is set to be represented by a light gray color (7).

Related Variables: The State3DefColor variable should be used together with the State0DefColor, State1DefColor, State2DefColor, and InvalidColor variables in order to make the default settings for different states unique and comprehensive.

Default: State3DefColor = 7

TrendAreaColor

Indicates the color of the background for the Trends page. By default, the background color of the Trends page is set to dark cyan (3).

Related Variables: The TrendAreaColor variable should be used together with the TrendHGridColor and TrendVGridColor, and the TrendColor0 through TrendColor11 variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendAreaColor = 3

TrendColor0

Indicates the color of the first pen (pen 0) when displayed on the Trends page. By default, the TrendColor0 variable is set to yellow (14).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor0 = 14

TrendColor1

Indicates the color of the second pen (pen 1) when displayed on the Trends page. By default, the TrendColor1 variable is set to light cyan (11).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default = 11 { light cyan }

TrendColor2

Indicates the color of the third pen (pen 2) when displayed on the Trends page. By default, the TrendColor2 variable is set to white (15).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor2 = 15

TrendColor3

Indicates the color of the fourth pen (pen 3) when displayed on the Trends page. By default, the TrendColor3 variable is set to light green (10).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor3 = 10

TrendColor4

Indicates the color of the fifth pen (pen 4) when displayed on the Trends page. By default, the TrendColor4 variable is set to light red (12).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor4 = 12

TrendColor5

Indicates the color of the sixth pen (pen 5) when displayed on the Trends page. By default, the TrendColor5 variable is set to light magenta (13).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor5 = 13

TrendColor6

Indicates the color of the seventh pen (pen 6) when displayed on the Trends page. By default, the TrendColor6 variable is set to light blue (9).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor6 = 9

TrendColor7

Indicates the color of the eighth pen (pen 7) when displayed on the Trends page. By default, the TrendColor7 variable is set to dark red (4).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor7 = 4

TrendColor8

Indicates the color of the ninth pen (pen 8) when displayed on the Trends page. By default, the TrendColor8 variable is set to brown (6).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor8 = 6

TrendColor9

Indicates the color of the tenth pen (pen 9) when displayed on the Trends page. By default, the TrendColor9 variable is set to dark green (2).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor9 = 2

TrendColor10

Indicates the color of the eleventh pen (pen 10) when displayed on the Trends page. By default, the TrendColor10 variable is set to dark blue (1).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default: TrendColor10 = 1

TrendColor11 

Indicates the color of the twelfth pen (pen 11) when displayed on the Trends page. By default, the TrendColor11 variable is set to black (0).

Related Variables: The TrendColor0 through TrendColor11 variables should be used together with the TrendAreaColor, TrendHGridColor, and TrendVGridColor variables in order to make the horizontal and vertical grids and the possible pen selection colors stand out from the background color set for the Trends page.

Default = 0 { black }

TrendHGridColor

Indicates the color of the horizontal grid lines for the Trends page. By default, the horizontal grid is set to 0 (black), so as to stand out against the default background color of the Trends page.

Related Variables: When setting TrendHGridColor, keep into consideration the setting of TrendAreaColor to ensure that the horizontal grid lines stand out from the background color set for the Trends page. To set the color of the vertical grid lines, refer to TrendVGridColor.

Default: TrendHGridColor = 0

TrendVGridColor

Indicates the color of the vertical grid lines for the Trends page. By default, the vertical grid is set to 0 (black), so as to stand out against the default background color of the Trends page.

Related Variables: When setting TrendVGridColor, keep into consideration the setting of TrendAreaColor to ensure that the vertical grid lines stand out from the background color set for the Trends page. To set the color of the horizontal grid lines, refer to TrendHGridColor.

Default: TrendVGridColor = 0

UnselectedBgnd 

Indicates the background color for alarm list items that are not selected in the alarm list.

If set to invalid (as it is by default), the background color for alarm list items not selected in the alarm list is derived from the GetSystemColor( 5) function.

Related Variables: The UnselectedText variable (see below) indicates the color for the text of non-selected alarm list entries.

Default: UnselectedBgnd =

UnselectedText

Indicates the text color for alarm list entries that are not selected in the alarm list.

If set to invalid (as it is by default), the background color for alarm list items not selected in the alarm list is derived from the GetSystemColor( 8) function.

Related Variables: The UnselectedBgnd variable (see above) indicates the background color for alarm list items that are not selected in the alarm list.

Default: UnselectedText =

WindowBgnd

Indicates the background color for windows.

If set to invalid (as it is by default), then the background color is derived from the GetSystemColor( 5) function.

Default: WindowBackground =

WindowFrame

Indicates the border color for windows.

If set to invalid (as it is by default), then the border color is derived from the GetSystemColor( 6) function.

Default: WindowFrame =