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

• Dialog Box ‘Create a new visualization style’

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.