Input

Dialog for configuring the visualization elements (Category Input):

../_images/c58bb43524a05c9d0a317f346d357f02

Toggle variable: If this option is activated, in online mode you will toggle the value of the variables which are located in the input field by each mouse click on the visualization element. You can obtain input assistance for data entry via F2. The value of the Boolean variable changes with each mouse click from TRUE to FALSE and then back to TRUE again at the next mouse click, etc.

Tap Variable: If this option is activated, in online mode you can switch the value of the Boolean variable which is located in the input field, between TRUE and FALSE. Place the mouse cursor on the element, press the mouse-key and hold it depressed. If option Tap FALSE is activated, the value is set to FALSE as soon as the mouse key is pressed, otherwise it is set to TRUE at this moment. The variable changes back to its initial value as soon as you release the mouse key.

Zoom to Vis…: If this option is activated, you can enter in the edit field the name of a visualization object of the same project to which you want to jump by a mouse-click on the element in online mode. In this case always first the window of the target visualization will be opened before that of the current one will be closed.

The following entries are allowed:

  • The name of a visualization object of the current project (see Object Organizer)

  • If a visualization reference that contains placeholders ( Placeholder) is to be jumped to, the placeholders can be directly replaced by variable names or text when called up. For this pupose, conform to the following syntax:

    <Visuname>(<Placeholder1>:=<Text1>, <Placeholder2>:=<Text2>,…, <Placeholder n>:=<Textn>).

    Example:

    Calling the visualization visu1, whereby the placeholders $var_ref1$ and $var_ref2$ used in visu1 are replaced by the variables PLC_PRG.var1 and PROG.var1 respectively:

    visu1(var_ref1:=PLC_PRG.var1, var_ref2:=PROG.var1)

  • If a program variable of the type STRING (e.g. PLC_PRG.xxx) has been entered instead of a visualization object, then this variable can be used to define the name of the visualization object (e.g. ,visu1’) which the system should change to when a mouse click occurs (e.g. xxx:= ,visu1).

  • If you issue the command „ZOOMTOCALLER” in the Zoom to vis. field, a backward jump into the calling visualization is achieved in Online mode by a mouse click on the element, if such a constellation was configured.

Note

The implicit variable CurrentVisu (type STRING, for implicit (system) variables see here) describes the name of the currently opened visualization object. For example it can be used in the application to control which visualization should be opened resp. to see which is the currently opened.

Note: with compiler version < V2.3.7.0, and if the library SysLibStr.lib is not included in the project, this will only work if the names of the visualization objects are defined in capital letters.

Example: CurrentVisu:=’PLC_VISU’;

Execute program: If this option is activated you can enter ASSIGN- or special “INTERN”-commands in the input field, which will be executed in online mode as soon as you perform a mouse-click on the element. Press button “…” to get the dialog Configure programs where you can select the desired commands (Add) and arrange them in the desired order (Before, After).

Note

This feature especially is important if the visualization will be the only operating interface of a system (pure operating version).

Text input of variable ‘Textdisplay’: If this option is activated, in online mode you can enter text in an edit field in this visualization element. This value upon pressing Enter will be written to the variable that appears in the textdisplay field of the ‘Variables’ category.

If option Hidden is activated, the text will be replaced by asterisks (“***”) in the online display of the visualization element.

Select in the scroll box which kind of input should be possible later in online mode

Text: An edit field will open, where you can enter the value.

Numpad resp. Keypad: A window will open showing an image of the numeric resp. alphabetic keypad, where you can enter a value by activating the appropriate key elements. This might be useful if the visualization must be operatable via a touch screen. The range of valid input values can be restricted by defining a minimum and a maximum value in the edit fields ‘Min’ and ‘Max’.

Note

In case of using Target-Visualization regard the possibility to get information on user inputs via mouse-clicks by special interface functions and to use that directly in the project.

In case of multiple definition of an element property consider the specific order of precedence concerning according to which a value might be overwritten in online mode by another.