Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Themes are a configuration feature designed to set colors in display objects in runtime and the Designer Workspace, and are optional on runtime displays.Themes are sets of visual styles that determine the appearance of pages and objects within an application, including colors and design elements. Their purpose is to standardize and customize the application's visual appearance, ensuring consistency across components. Themes function as collections of design parameters that control color schemes and layout aesthetics.

The Designer tools has a set of five light and five dark themes. Those same themes, plus 2 high-contrast and 2 custom themes, are available to be used in the runtime, for operator displays. 

On this page:

Table of Contents
maxLevel3
stylenone

Image Added


Applying

Themes

Theme Colors

On the Solution Designer (engineering workspace) go to Home, and select the Theme at the Welcome Page, or in the User Preferences dialog.On the Designer Drawing tool

, at When drawing displays, the Properties Sidebar, there is an option RuntimeTheme ComboBox, which allows the drawing editor to emulate the runtime theme, only in the drawing area.When drawing displays, selecting styles via the Brush Editorhas the colors editors, to select colors for Border, Fill, and Text Elements. 

Image Added

The THEME and HPG presents the colors that automatically changed, when a global theme is selected for the solution. 

The THEME tab has the generic colors (the list is filtered automatically accordingly as you edit a background, border or text color), the HPG section has colors that following the specification for High Performance HMI Graphics. 

Image Added

When drawing the displays, the Properties SideBar has a section Appearance, with the Theme ComboBox.

Image Added

That option will change the preview of the display, when running on the Designer tool.

When running the solution, change dynamically the Theme using the property @Client.Theme.


Working with Themes

Selecting a Startup Theme

You can select a pre-created Theme to startup your solution.

To do so, go to Displays → List, and click Windows button at Client Settings. It will open a popup window where the Initial Theme field is on the bottom. 

Note

If the field is left blank, the solution starts up without any theme using the objects properties used at the moment the displays were created.

Changing a Theme in Runtime

Theme selection in runtime can be done by using the syntax below in Script codes, Expression fields, or objects configuration.

To set the solution to the default configuration, without a custom theme, you need to set the Client.Theme to an empty string (Client.Theme= ””) or create an empty theme table and assign it to the theme property.

Code Block
@Client.Theme = "Blue";
@Client.Theme = "Dark";
@Client.Theme = "Yellow";
@Client.Theme = "";



Pre-defined Theme Colors

Go To Displays → Themes in order to view the various Themes dents and its color pallet. 

A Theme pallet incudes standard color for visual elements like:

  • DefaultColor

  • DisplayBackground

  • HeaderBackground

  • TextForeGround

  • All HighPerformance State (all of them start with HP, ex: HPOnStroke, HPOffStroke, HPDisableStroke)

  • Dashboard pages (all of them start with Dashboard, ex: DashboardTitleBackground, DashboardItem…)

When you create displays consistent with those standards, when a new Theme is loaded, the visuals of your displays will remain consistent.

See below the full list of standards:

Item Name

Description

DefaultBrush

Sets the base color for UI elements without specific color settings.

DefaultBorder

Defines the standard color for the borders of UI components.

WatermarkBrush

Assigns a specific color for watermark elements.

ThemeBlackBrush

Sets a standard black brush color.

ThemeWhiteBrush

Sets a standard white brush color.

AccentBrush

Assigns a color to highlight interactive or key elements.

PageBackground

Applies the color for the primary background of pages.

PanelBackground

Sets the background color for panels.

PopupBackground

Applies the color for pop-up windows.

ControlBackground

Defines the background color for standard UI controls.

ComboBoxBackground

Sets the background color specifically for combo boxes.

ButtonBackground

Applies the background color for buttons.

LightBrush

Assigns a color to specific elements within a GroupBox.

ShadeBrush

Applies a color to create contrast within a GroupBox.

BayBrush

Applies a color to specific diagram elements.

LegendBrush

Sets the color for legend text or icons in diagrams.

TextForeground

Applies the color for standard text.

TextAccentForeground

Assigns a color to accented text.

TextSubtleForeground

Sets the color for secondary or less prominent text.

TextHyperlinkForeground

Applies a color to hyperlinks.

HeaderForeground

Applies the color for header text in dashboards.

HeaderBackground

Sets the background color for dashboard headers.

ItemBackground

Applies the color for individual dashboard items.

ItemBorder

Defines the border color for dashboard items.

SelectFocusBrush

Applies the color to indicate the focused item.

SelectBrush

Sets the color for selected items within lists or dropdowns.

FocusBrush

Applies the color to elements in focus.

HoverBackground

Sets the background color for elements when hovered over.

HoverBorder

Applies a color to the borders of elements during hover.

PressedBackground

Sets the background color for elements when pressed.

PressedBorder

Defines the border color for elements when pressed.

DisabledForeground

Applies a color to text and icons in disabled controls.

DisabledBackground

Sets the background color for disabled controls.

DisabledBorder

Applies the border color for disabled controls.

HpgDefaultFill

Sets the fill color for default graphical elements.

HpgDefaultStroke

Applies the stroke color for default graphical elements.

HpgOnFill

Sets the fill color for elements in an "on" state.

HpgOnStroke

Applies the stroke color for "on" state elements.

HpgOffFill

Sets the fill color for elements in an "off" state.

HpgOffStroke

Defines the stroke color for "off" state elements.

HpgElementBlueColor

Applies a specific blue color to highlight specific data or states.

HpgElementLightBlueColor

Sets a lighter blue for differentiation within similar elements.

HpgElementDarkBlueColor

Applies a darker blue for contrast within graphical elements.

HpgElementGreenColor

Sets a green color for positive or successful states.

AlertHighPriorityColor

Applies color to high-priority alerts for urgent notifications.

AlertMediumPriorityColor

Sets the color for medium-priority alerts. Ensures visibility for non-urgent alerts.

AlertLowPriorityColor

Applies color to low-priority alerts.

AlertDiagnosticColor

Sets the color for diagnostic alerts.

AlertNormalColor

Applies color to normal, non-critical alerts.

CustomBrush1

Custom color.

CustomBrush2

Second custom color.

CustomBrush3

Third custom color.

CustomBrush4

Fourth custom color.



Available Dark and Light Themes

The built-in themes in the platform are designed to optimize your workspace for both functionality and aesthetics. Each theme is available in both a light and dark version, catering to various lighting conditions and personal preferences.

Theme Pairs:

  • Light & Dark:

    • Light: A clean and bright theme, perfect for use in well-lit environments.

    • Dark: A sleek and subtle theme, ideal for low-light conditions, reducing eye strain.

  • Sky & Navy:

    • Sky: A theme that embodies the lightness and tranquility of a clear sky.

    • Navy: A deep, calming theme inspired by the serene depths of the ocean.

  • Gold & Coffee:

    • Gold: A warm, elegant theme that adds a touch of luxury to your workspace.

    • Coffee: A rich, earthy theme that brings a cozy, grounded atmosphere.

  • Pearl & Indigo:

    • Pearl: A soft and inviting theme, creating a gentle, soothing workspace.

    • Indigo: A bold and refined theme, offering a deeper, more vibrant look.

  • Steel & Graphite:

    • Steel: A modern, cool theme that reflects a contemporary style.

    • Graphite: A darker, industrial-inspired theme that provides a strong, minimalistic feel.

  • HighContrastLight & HighContrastDark:

    • HighContrastLight: Designed for maximum visibility in bright conditions, with sharp contrasts.

    • HighContrastDark: Offers high contrast for enhanced readability in darker environments.

  • CustomLight & CustomDark:

    • CustomLight: A flexible theme that allows you to create a personalized light workspace.

    • CustomDark: Customize your dark theme to suit your specific needs and style.


In this section:

Page Tree
root@parent
spacesV10