## Text Input

Text Input is used to write value to a PV and display the readback PV value. It does not supports multi-line text. It supports parsing String as a Double or Long Integer array.

If setting its `Style` property to native, it will use the native text widget provided by the operating system, so it can support native border looking, password input, Tab traverse and selecting text at Runtime.

### Operations

At runtime, clicking the widget to edit text. Press `ESC` key to abort editing. If there is no `PV Name` set for the widget, lost focus or clicking other place on the OPI will set the text. If `PV Name` is set, it requires explicitly hitting `Enter` or `Ctrl+Enter` to write the PV. If `Multi-line Input` property is `no`, press `Enter` key to submit text. If `Multi-line Input` property is `yes`, press `Ctrl+Enter` to submit text. Note: Even if you did not change the text, press `Enter` or `Ctrl+Enter` will still write the text to PV.

If the `Format Type` is not `String`, it allows to write numeric array to numeric array PV with text format like `13 22 33 24`.

### Special Properties

Besides its own special properties, the widget has all the special properties of TextUpdate.

- Style (style).
    Classic or Native Style.
- Confirm Message (confirm_message).
    If this is not empty, a confirm dialog will pop up before writing the new value to PV.
- Minimum (minimum).
    The lower range of the allowed input if PV is numeric type.
- Maximum (maximum).
    The upper range of the allowed input if PV is numeric type.
- Limits From PV (limits_from_pv).
    Load the allowed Minimum and Maximum from PV.
- Multi-line Input (multiline_input).
    Allow inputing multiline.
- Selector Type (selector_type).
    The type of the selector. Supports File selector and Datetime selector.

Properties only visible to File selector:

- File Source (file_source).
    The source of the file.It can be workspace file or a file from local file system.
- File Return Part (file_return_part).
    Which part of the path should be returned. It could be full path, file name and extension or file name only.

Properties only visible to Datetime selector:

- Datetime Format (datetime_format).
    The format of the datetime. It is an arbitrary combination of `yyyy` (year), `MM` (month), `dd` (day), `HH` (hour), `mm` (minute) and `ss` (seconds).
    For example,
    `yyyy-MM-dd HH:mm:ss` would look like `2011-04-26 14:43:00`
    `MM/dd/yyyy HH:mm:ss` would look like `04/26/2011 15:04:00`
    `MM/dd/yyyy` would look like `04/26/2011`.

Properties only visible to Native Style

- Next Focus (next_focus).
    The next widget to get focus after finishing inputting on this widget. The "Next" option is useful if you are embedding this widget in an array widget or have several text widget and want to input data one by one.
- Show Native Border (show_native_border).
    Show the native border of this widget.
- Password Input (password_input).
    Use as a password input widget.
- Read Only (read_only).
    True if this widget is not editable.
- Show Horizontal Scrollbar (show_h_scroll).
    Show native horizontal scrollbar.
- Show Vertical Scrollbar (show_v_scroll).
    Show native vertical scrollbar

### See Also

- Properties Common to PV Widgets
- Properties Common to All Widgets