6.5.1 Settings

Assign the address or tag name to receive a value from the key input window object.

The input data will be written to a real device address with BIT or WORD data. You can enter the device address by typing it in the ‘Input Device Address’ dialog box or by pressing the button.

The input data will be written to a database tag. You can assign an analog tag, digital tag, or string tag. You can enter the tag name by typing it in the ‘Tag’ dialog box or browse for a tag in the database by pressing the button.

Executes the command expression in the text field whenever the end-code character is entered (by default, “Enter” is the end-code character). You can use the “Addr” and “Tag” buttons to include addresses and tag names in the expression. Note that when “Completed When Unselected” is checked, selecting then de-selecting the key input window will also activate the command expression.

You can assign a script priority for the command expression. The priority can be set between 0 (the lowest priority) and 10 (the highest priority). Higher priority scripts will generally be executed sooner and more frequently than lower priority scripts. Note: It is currently not recommended to use a priority higher than 9 for user-created scripts.

Assign the background and line color for the input box. You may choose from 98 colors.

Assign the position and size (in pixels) of the input window. Note that the X position goes from left to right, while the Y position goes from top to bottom.

Displays the key input value with a specified number of digits. You can assign between 0 and 255 digits. ‘0’ indicates no limitation for the number of digits. Note that for non-integer key input values, the decimal place itself counts as a digit. Thus, when the “Decimal Places” number is greater than 0, the “Digit” number must be at least 2 greater than the “Decimal Places” number.

Defines the maximum number of digits to be displayed after the decimal place. When set to 0, the decimal place will not be displayed.

You can edit the assigned tag or address directly from the [Key Input Window] object setup window. If a tag which does not exist in the database has been assigned, you can use the ‘Tag Edit’ button to create a new tag with the corresponding name.

※ This option is supported in XpanelDesigner V2.53 and above.

Enter the hexadecimal code which corresponds to the end-code character. ‘0D’ signifies the ‘Enter’ key and is chosen by default. The end-code uses the encoding of the Xpanel virtual keyboard, which is 8-bit ASCII (256 characters).

When selected, all characters will be displayed as ‘*’ to hide passwords.

When selected, inserts commas to separate every three digits in the displayed tag value.

Displays a virtual keyboard when the object is double-clicked. This option is useful when no keyboard is connected to Xpanel.

If the data input exceeds the maximum digit length, earlier input will be deleted, and a new value will begin receiving input.

Updates the displayed tag value continuously until the user begins typing.

Removes the borderline surrounding the key input window object.

When the focus is moved away from the key input window object, the input value will be applied to the corresponding tag without hitting enter. Note that if both this option and the “Executive Command by End-Code” option are used, then moving the focus away from the key input window object will trigger the specified command expression.

※ This option is supported in XpanelDesigner V2.53 and above.

Allows maximum and minimum values to be assigned for analog tag input.

Configures optional actions to apply when the end-code character (“Enter” by default) has been entered.

Removes the cursor from the window. To input data again, the key input window must be selected again.

When a new value is entered, the displayed content will be removed from the key input window. This input value will still be saved to the tag; only the displayed value will change.

When using multiple key input window objects, this option allows you to move to the next input field based on the “Order of Enter” number. If the same number is assigned to multiple objects, the focus will move to the object which was created first.

Sets the selection order for key input window objects when using the “Move to Next Input” option. You can assign a value between 1 and 100.

Allows an input condition to be assigned which makes the key input window object usable.

Enter a logical expression that must be true to enable key input. If the condition is not satisfied, you cannot enter data in the object. The condition should be of the form

<Value1> <operator> <Value2>

where each <Value> is a tag, device address, or constant, and each <operator> is one of (=, <, >, =<, =>, or !=).

The focus will automatically move to the object when the condition is satisfied.