Editor 'Visualization Style Editor'

Symbol:

Function: The editor is used for creating, deriving, editing, and localizing visualization styles. In addition, it makes it possible to check and install a style or a hierarchy of styles.

Call:

  • In CODESYS:

    In the Visualization Manager object (tab Settings, group Style Settings, click for a drop-down list). Click Open Style Editor.

  • Start menu > CODESYS installation folder > 'CODESYS' > 'Visualization Style Editor'

Menu 'File'

New style

The Create a New Visualization Style dialog box opens.

Open

The Open Dialog dialog box opens.

This dialog prompts you to select a style file (format .visustyle.xml) to be opened and edited.

Open as copy

The Open Existing Style as Dialog dialog box opens.

This dialog prompts you to select a style that is copied, saved to the target location, and opened for editing.

Close

Closes the style open in the editor.

Save

Saves the changes of the open style.

Save As

The Select Visualization Style(s) dialog box opens.

This dialog prompts you to select a file to save the current settings.

Save and Install

Saves the open visualization style and installs it to the visualization style repository.

Recently opened files

Lists the files for selection that were last opened.

Abort

Closes the visualization style editor.

See also

Menu 'Styles'

The commands affect the contents of the Style Properties tab.

New Entry (as Child)

Creates another style entry as a child of the selected style property.

New Entry (Afterwards)

Creates a new style entry in the list after the selected style property.

Move Down

Moves the selected style entry down.

Requirement: Sort order is flat.

Move Up

Moves the selected style entry up.

Requirement: Sort order is flat.

Sort Order

Toggles between three sort orders:

  • Flat structure and alphabetical order

  • Flat structure and order according to the position of the entry in the XML style file

    This position also determines the position of the property in CODESYS. The property appears, for example, in the Properties view below the Values column in the drop-down list for style properties.

  • Hierarchical structure of entries

    Requirement: The names of the style properties contain at least one dash.

Check

The settings of the style properties are checked for consistency errors. This check is also performed when saving the style.

Menu 'Localization'

The commands affect the contents of the Localization tab.

Add Language

The dialog box Add New Language opens. The dialog prompts you to specify data for creating a new language column.

Remove Selected Language

Removes the columns of the selected cell.

Rename Selected Language

The Rename Language dialog box opens. The dialog is used for renaming the column that defines the selected cell and removes all previous translations.

Dialog box Add New Language

Name

Name of the new language as a language code according to ISO 639-1.

Examples: de, en, es, it, fr, ja

Copy from existing

All existing language columns are available for selection. The selected language is copied with all entered translations.

<do not copy text>: The new language receives a blank translation column.

Tab 'General'

This tab contains the general metadata of the open style file and allows it to be edited.

Identification

Company

Example: Xy-z GmbH

Tip: In the installed styles, CODESYS can filter by the company names specified here.

Name

Example: Style_A

Version

User-defined version number

Example: 1.1.1.1

General Settings

Base style

Name and version of the style that the open style is based on.

Tip: The derived style properties from the base style are highlighted in yellow in the Style Properties tab.

Partial style (usable only as base for other visualization styles)

: The style is identified as incomplete. Therefore, it can be used for other styles as a base style only.

Example: Style only with color definitions that derive this to many other styles.

Note: CODESYS does not check for consistency errors of an incomplete style for itself.

: The style is identified as complete.

From

The Select Base Style dialog box opens. This dialog prompts you to select a style file that is saved to the file system (and not does not have to be installed). The file is used as a base style.

Informational

Visualization profile

The profile is intended for informational purposes. For example, you find elements that are not preconfigured with special style entries, and information from the profile. In addition, CODESYS checks in the profile whether a required style is missing.

Tab 'Style Properties'

This tab lists the names of the style properties with the associated values and makes it possible to edit it, even by means of the commands in the Styles menu.

The style properties can be defined for colors, fonts, images, and any values.

The style properties defined in a base style are derived and highlighted in yellow.

Name

Name of the style property.

If the name contains a dash, then the Visualization Style Editor can sort the style properties by the prefixed terms before the dash and display them in a hierarchy. A name can contain more than one dash.

Value

Value that is assigned to the style property.

Type

Data type of the style property; selected from a drop-down list.

Note: This is possible and necessary only for specific style properties with a data type that is not implicitly defined.

Attribute

hide: The associated style property is not listed in the drop-down lists in CODESYS.

Used by

Visualization element that can be configured with this style property. Can be edited.

Comment

Example: Special setting for Bar Display. Optional.

Double-click a cell.

An input field opens for editing.

Del

Removes the selected row.

Tab 'Localization'

This tab makes it possible to translate the names of the style properties into other languages.

Name

Lists the name of the style properties as they are defined in the Style Properties tab.

<language>

Identification of the language name (as language code according to ISO 639-1) in which the style property name should be translated.

Double-click a cell.

An input field opens for editing.