Dialog: Properties

Function: Configuration of object-dependent properties

Call: Menu bar: View; context menu of the visualization object in the Devices view or POUs view

Tab: Common

Name	Example: `visMain`
Object type	Visualization
Open with	Visualization

Tab: Build

The tab contains options for compiling the object.

For more information, see: Dialog: Properties: Build

Tab: Access Control

Function: Configures which user groups can execute which actions on the object

Tab: Visualization

Function: Assigns a visualization type to a visualization

It also includes settings for window size which are used at runtime.

Important

The settings deal with the behavior of the object when the application is in online mode. The behavior of the editor in offline mode is not affected by the following settings.

Use Visualization as	List box with the visualization types listed below
Visualization	Visualization type for an ordinary or referenced visualization
Dialog	Visualization type for a visualization which opens as a dialog in its own window for an input event The input action for this is Open dialog. The Close dialog input action closes the window. Tip A dialog usually includes an OK button or Cancel button at the bottom edge for confirming or rejecting user input, and for closing the dialog. A simple dialog or a dialog prompt includes only a question or information and buttons for closing the dialog with either Yes or No. A dialog is always part of a user interface. While a dialog is open, the user can usually not access the rest of the user interface. When the overlap functionality is enabled, the dialog can be moved to any position at runtime.
Numpad/ Keypad/ dialog for input configuration	Visualization type for a visualization that displays a virtual numeric keypad or a virtual keyboard It opens when the user is prompted to specify a text. The input action for this is Write Variable. Note The interface of this visualization also have to conform with the interfaces for the standard visualizations for the numeric keypad or the keyboard that provides the `VisuDialogs` library: `Numpad`, `Keypad`, `NumpadExtended`, or `TextinputwithLimits`. Tip The `VisuDialogs` library contains templates for virtual keyboards and numeric keypads.
Login visualization	Visualization type for the login page of a WebVisu or TargetVisu for which runtime-based user management is configured Only a certain selection of visualization elements is available for this visualization type. Because no IEC variables can be used, multiple placeholders are available for the configuration of the input fields and buttons. With the input configuration, it is possible to configure a link to a web page with the Execute Command input action and the Navigate to URL (WebVisu) command on the login page. When the visualization is started, the login page is displayed first, where the user has to enter the user name and the user password.

Dialog is opaque	: The screen area that is covered by the dialog is not refreshed. This has a positive effect on the character and input performance. Tip Use this option when your drawn dialog is rectangular and opaque and it does not contain any transparent parts.
Use automatic detected visualization size	: The size is determined so that all visualization elements are included.
Include background image	: All elements and the background image are completely visible. : All elements are visible, but a larger background image is truncated.
Use specified visualization size	: The Height and Width values define the window size of the visualization (in pixels).

Internal

standard icon : Internal POU of a library (library visualization)

A visualization marked as Internal in a CODESYS library project is treated as usual. The visualization can be opened and its name appears in list boxes.

If this library is used in a project, then the visualizations marked as Internal are not visible in the project.

This option is intended for library developers to mark a visualization as a library object. The visualization is not visible outside of the library.

Use visualization and container size properties

standard icon : For visualizations which are displayed in a superordinate container element or in a superordinate visualization, variables for the size of the available area are generated automatically. In this way, the visualization can adapt to the available area which is provided by the referencing element.

Variables which can be passed in the Absolute movement property:

Container.Width, Container.Height
Variables for the size of the available area: In this case, it is the size of the referencing element of type Frame or Tabs.
Visu.Width, Visu.Height
Variables for the size of the available area: In this case, it is the size of the referencing visualization.

Hint: Disable this option if your application has more than one variable named Container or Visu.

Toolbox Display
Use custom category	: The element is displayed under a custom localized category, corresponding to the specified text list entry. : A general visualization category can be selected.
Category	Category name for the toolbox under which the visualization object is displayed Defined as a text list entry <text list>.<ID> which refers to the multilingual category names
Image	Image (SVG) for the toolbox which is displayed as a thumbnail for the element Defined as an entry in the image pool <image pool>.<ID> which refers to an SVG image