Input Action: Write Variable

Input Action: Write Variable

The configuration of the input action defines how a visualization user specifies a value and to which variable the value is written.

“Input type” How the input is prompted
“Default”	Input field, or if necessary a virtual keyboard (if the display variant does not have a physical keyboard) Note: The default option for text input at runtime is set in the Visualization Manager: “Dialog Settings” tab, “Settings for Default Text Input”.
“Text input”	An input field is displayed. As the visualization user, you can use the keyboard to specify a number or a text. Requirement: The display variant has a keyboard as input device.
“Text input with limits”	An input field is displayed. You use the keyboard to specify a number or a text. The field also shows the value range for the input. When a limit is passed, the input value is displayed in red. Requirement: The display variant has a keyboard as input device.
“VisuDialogs.Keypad”	A virtual keyboard opens. You use it to specify a number or a text.
“VisuDialogs.Numpad”	A virtual keyboard opens. You use it to specify a number.
“VisuDialogs.NumpadExtended”	A virtual keyboard opens. You use it to specify a number. Hexadecimal and exponential notation are also permitted here.

“Choose variable to edit”
“Use text output variable”	: The input value is written to the text output variable of the element. This is the variable that is assigned in the “Text variable Text” property.
“Use another variable”	: Variable where the input value is written. Example: `‎PLC_PRG.iVariable‎`
“Initial display format”	Placeholder with format definition. It defines the output format for the variable value and the input limits. Example: `‎%2.3f‎` for displaying the value as a decimal fraction.

“Min”	Minimum value of the input limit. If a user specifies a lesser value, then it is not accepted. As a fixed value As a variable (data type corresponds to selected variable)
“Max”	Maximum value of the input limit. If a user specifies a greater value, then it is not accepted. As a fixed value As a variable (data type corresponds to selected variable)
“Dialog title”	Text displayed in the title bar of the dialog. Optional. As a fixed string Example: `‎Insert value‎` As a variable (`‎STRING‎`) Example: `‎PLC_PRG.stTitle : STRING := 'Insert value';‎`

“Password field”

: ‎***‎ is displayed instead of the input text.

“Position to Open Input Dialog”	Initial position for the opening input dialog relative to the calling visualization
“Use global setting (from the Visualization Manager)”	Requirement: This option is available only when displaying on a TargetVisu or as a WebVisu. : The position which is set in the Visualization Manager on the “Dialog settings” tab is used.
“Centered”	: The dialog is displayed in the center.
“Position”	: The dialog is displayed at the position set below. Note: Use the corresponding input options for specifying the position in the X-direction and the Y-direction.
“X”	Horizontal X-position for the upper left corner of the opening dialog Input options: Fixed (in pixels) As an IEC variable (integer data type) Placeholder: `‎ElementRectangle.ptTopLeft.iX‎` The placeholder is replaced by the position of the upper left corner of the element. Placeholder:`‎ElementRectangle.ptBottomRight.iX‎` The placeholder is replaced by the position of the lower right corner of the element.
“Y”	Vertical Y-position for the upper left corner of the opening dialog Input options: Fixed (in pixels) As an IEC variable (integer data type) Placeholder: `‎ElementRectangle.ptTopLeft.iY‎` The placeholder is replaced by the position of the upper left corner of the element. Placeholder:`‎ElementRectangle.ptBottomRight.iY‎` The placeholder is replaced by the position of the lower right corner of the element.