Manual > Library Reference > Part Library > Basic Parts

Character input 1

parts_inputstring1_001

Text Input 1 is a component for writing text entered on the screen to a tag.

When the edit is confirmed, the value is written to the input/output tag.

Specify the tag to be input/output as the input/output tag (_TagInOut). The value of the input/output tag will be the initial display, and thereafter the display will be dynamically updated every time the value changes.

When editing a value, only the number of characters specified in the character length will be accepted. When the edit is confirmed, the value will be written to the input/output tag.

In addition, by specifying a tag for fault identification in the fault identification tag (_TagFault) separate from the input tag, a fault can be displayed based on signals such as equipment abnormalities received from downstream.

Custom Properties

Tag configuration	Input/Output Tags	_TagInOut	Specifies the tag path of the input/output tag.
	Fault Identification Tag	_TagFault	Specifies the tag path of the fault identification tag.
Display settings	caption	_Caption	Specify a caption.
	Character length	_Length	Specify the length of characters that can be entered (number of characters). Full-width and half-width characters are not distinguished.
	Value Text Color	_ValueTextColor	Specifies the color of the value text.
	Value Background Color	_ValueFillColor	Specifies the background color of the value.
	Caption Color	_CaptionColor	Specifies the color of the caption.
	Background Panel	_BackPanelColor	Specifies the color of the background panel.
Input assistance settings	cursor	_StartCursor	Specifies the initial cursor state when focused. •NONE - Do not select •MOUSE - Set cursor to mouse position •LEFT ・・・Sets the cursor to the left of the input value •RIGHT ・・・Set the cursor to the right of the input value •SELECTALL ・・・Select all the entered values
	Keyboard display	_ShowKeyboard	If enabled, the keyboard dialog will be displayed on focus.
	Operation history output	_Log	If enabled, the operation history will be output when a value is written. If you want to output the operation history in a standard project that uses the standard framework, enable the operation history setting from the system administration settings screen. For details, see "Operation History Settings". If you want to output the operation history in an original project that does not use the standard framework, define Alarm server to record the operation history and set the root DefaultFireAlarm property appropriately.
	Operation Message	_LogMsg	Specify the message to be output to the operation history.

Usage Example

1) Input/output tag specified/no fault identification tag

parts_inputstring1_001

The value of the input/output tag is displayed as is as a string.

When the tag value changes, the display updates dynamically.

parts_inputstring1_002

When the item is focused by clicking the mouse, the value can be edited.

In the example on the left, all items are selected using the cursor setting "SELECTALL".

parts_inputstring1_003

Enter a string from the keyboard. You can enter a string up to the number of characters set in the character length.

If you lose focus by pressing the Enter key or clicking on another object, the input will be confirmed and the entered string will be written to the input/output tag.

When the quality flag of the input/output tag is BAD, a fault is displayed.

parts_inputstring1_004

The part will be framed in yellow and will flash.

When a fault is displayed, the input frame is disabled and editing is not possible.

By setting the "FocusHover" property of the form to which the component is attached to True, a focus frame will be displayed when you move the mouse cursor over the component you want to operate.

2) Input/output tag specified/fault identification tag

If you specify a fault identification tag, you can receive the fault status of the device via the tag. For example, if you can receive a fault status (such as a sensor abnormality) from the downstream side as a signal separate from the device's measurement value, you can specify the tag path of that signal as the fault identification tag to display the fault along with the state of the quality flag of the input tag.

parts_inputstring1_001

When the fault identification tag is False, the value received by the input/output tag is displayed and can be edited as usual.

parts_inputstring1_004

A fault is displayed when the fault identification tag is true or when the quality flag of the input/output tag is bad.

When a fault is displayed, the input frame is disabled and editing is not possible.

3) Keyboard display

If you enable keyboard display (_ShowKeyboard), the keyboard dialog will be displayed when the control is focused.

parts_dialog_inputkey_001

You can edit values using the keyboard on the dialog. After confirming your input with the Enter button, click the OK button to close the dialog, and the edited results will be reflected in the input box and the value will be written to the input/output tag.