The Input text form field is used to let the user of the form specify
a text value. Examples: first, middle and last name, password, phone number,
description of a user account, extra SMTP E-mail address. In the screenshot
below the fields next to the text New
password and Confirm
password are input text fields.
To add an input text field
field, activate the form and
select menu option Add form field.... Select form field type Input
text field and press OK.
Text
Specify the text that is initially displayed in the input text field. When
you tab
through the formand the
form field gets the focus, all of the content of the input field is selected.
When you start typing the input text, the selection is removed.
Variables
Select a variable from the list and press the Insert button to insert the
variable name at the current position in the Text
field. At
runtime, when the form is shown, the value of the variable is shown.
Text
field support multiple lines with ... visible lines
Select this option to make the text field a multi-line input field. In
this case, the form user can specify a number of input lines for the input
field. When the user enters the text, the form field will wrap to the
next line automatically. If you do not select this option, the field height
is limited to a single line of text.
Margin
between field border and text of ... pixels
The specified margin is used to draw a border around the input text field
when specified.
Password
style, all characters shown as an asterisk (*)
When the user enters text in the input text field, each character is represented
as an *-character. This style is normally used to specify passwords.
Draw
border of input field
Draw a border around the input text field. The border clearly indicates
the position of the input text field.
Accept
carriage return (<Enter>) characters
When selected, the text in the input field can be entered using <Enter>
characters. Such a character moves the cursor to the next line in a multi-line
input text field.
Variable
- On submit, store contents in variable ...
Specify the name of the variable that is used to pass information entered
in the input text field, to for instance the script of the form project.
When a submit button is pressed, the entered text is stored as the value
of the specified variable. If you do not specify a variable name in this
field, the input text field cannot be stored. The list shows the names
of the variables found in the various project components. Instead of selecting
a variable from the list, you can also simply enter the name of a (new)
variable.