Tab: Settings

Use unicode strings

: The visualization encodes strings in Unicode.

Use CurrentVisu variable

: The application recognizes and uses the global variable VisuElems.CurrentVisu of type STRING.

It contains the name of the active visualization at application runtime.

In the application code, the variable can be read in order to retain the name of the active visualization. The variable can be written to for calling a switch of visualizations. The switch is done at the same time on all display devices.

Example: A TargetVisu display variant and several WebVisu display variants are active. When the CurrentVisu variable is written to, all display variants switch to this visualization.

Requirement: The application includes a visualization that calls other visualizations.

Support client animations and overlay of native elements

: Visualization elements can be animated by the client.

This function is possible only for browsers of a CODESYS WebVisu and in a CODESYS TargetVisu. However, CODESYS TargetVisu has to support this function. Then, additional properties are visible in the visualization elements.

Moreover, native elements, which are integrated in the visualization (for example, a web browser), can be overlaid with native CODESYS elements. This is not possible with CODESYS versions before 3.5.16.0.

Selected style

Opens a list box with styles that are installed in the Visualization Style Repository

Display all versions (for experts only)

: The list box includes only the latest version of the selected style and all other styles. If a newer version is installed for the selected style, then it is also listed.

: The list box contains all versions of all installed styles.

Button:

Opens list box with commands for using the Visualization Style Editor

Open Style Editor

The Visualization Style Editor opens.

Create and Edit Derived Style

The Visualization Style Editor opens with the Create New Visualization Style dialog. The dialog contains the settings for the first configuration step.

Requirement: In Selected style, a base style is selected.

Copy and Edit Style

The Visualization Style Editor opens with the Open Existing Style as Copy dialog. The dialog contains the settings for the first configuration step.

Requirement: A style is selected in Selected style.

Preview

The displayed elements represent the style that is specified in Selected style.

Selected language

Language used by the display variant when starting a visualization

Multitouch handling

This property defines what handles the touch events. This is done either by the visualization or, in the case of the WebVisu, by the browser. With this setting, touch gestures can be performed on various visualization elements.

: The visualization processes user input via gestures, touch, and mouse events. The WebVisu does not forward these events to the browser (no scrolling possible). The forwarding of events affects only the WebVisu, not the TargetVisu.

: The visualization does not process input events explicitly. Mouse, touch, and gesture events work as usual in the browser.

Scroll elements with scrollbar

: The scroll elements are displayed with a scroll bar. The contents excerpt can be scrolled with the mouse only this way.

: Scrolling by panning is enabled.

The visualization elements Table, Alarm Table, Combo Box, Integer, Combo Box, Array, and Frame with the Fixed and scrollable property are affected by this option.

Semi-transparent drawing

: The visualization paints the elements in a semitransparent color.

When defining a color, you can also specify the gradient value for transparency. This value is defined in the Transparency property.

The leading byte is evaluated in color variables.

Default: enabled.

Requirement: You have created a new visualization and the display variants can paint with semitransparency.

Standard keyboard handling

Paint disabled elements grayed out

: All disabled elements are grayed out without you having configured their element properties, such as color variables.

Call after visu initialization

Function name. The function is called after initialization. That is the right time to register an additional event handler for the EventManager.

Example: VisuInit

Implementation of VisuInit:

// This function is called after visu initialization (see Visualization Manager 'Call after visu initialization')
FUNCTION VisuInit : BOOL
VAR_INPUT
END_VAR
// Set the mouse event handler
VisuElems.VisuElemBase.g_VisuEventManager.SetMouseEventHandler(PLC_PRG.evHandler);

Another user case is the registration of the ClientManagerListener for the ClientManager.

Responsive visualization size

The size of the visualization is refreshed when the client size is changed. The elements in the top-level visualization can be positioned dynamically. The requirement is isotropic or anisotropic scaling.

The client size can be queried with the Container.Width and Container.Height variables.

Container.Size is the client size for all top-level visualizations. In order for a visualization with repositioned elements to scale correctly again, Visu.Size has to be recalculated.

Example:

Container.Width - Visu.Width
Container.Width - Visu.Width - 50