| Category: Text fields
Password field |
|
A password text field with an optional leading label. The user input is displayed with '*' characters. The user input is saved to a variable. |
Properties: |
-
Help text [Help]
If a text is entered into this property, a tooltip label with a help icon will be created on the right side of the form component that will display the help text when the user hovers with the mouse above the icon. The text can be plain text or HTML. For multi-line labels, use HTML like this: <html>This is line one<br>This is line two</tt>.
-
Text [Label]
The text of the label. Can be empty. To configure a keyboard shortcut, prefix the mnemonic character in the label text with &, e.g."&User". The prefixed character will be underlined and the platform-specific keyboard shortcut (e.g. ALT+[character] on Windows) will allow the user to quickly navigate to this form component with the keyboard.
-
Icon [Label]
An image file with an icon for the label. Can be empty.
-
Icon-text gap [Label]
The gap between the label icon and the label text in pixels.
-
Font color [Label]
The color of the label font. If empty, the default color will be used.
-
Font [Label]
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Initial text [Password field]
The initial text in the text field. Can be empty.
-
Prevent empty user input [Password field]
If selected, empty user input is not accepted and a default error message is shown in that case. This is a quick validation option so that you do not have to validate user input in the validation script of the form screen, as it would be necessary for more complex validations.
-
Font [Password field]
The font of the text field. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Text field columns [Password field]
The width of the text field, expressed as a multiple of the width of the character 'm'. If zero, the text field will fill the entire horizontal space.
-
Write encoded value to response file [Password field]
Write an encoded value of the entered password to the response file. Note that the encoding only prevents casual observation of the password. Do not enable if you require strict security for the password.
-
Variable name [User input]
The name of the variable to which the user input is assigned. The type of the variable value is java.lang.String
-
Key validation expression [User input]
An expression or script that validates each key that is pressed in this component by the user.
-
Input validation expression [User input]
An expression or script that validates the user input when the password field loses the focus. If the expression returns false, the focus remains in the password field. In that case you should display an error message.
-
Enter goes to next screen [User input]
If selected, hitting the ENTER key while the text field is focused, will go to the next screen, just as if the user had clicked on the "Next" button.
-
Request focus [User input]
If selected, the form component will request the focus after the form is activated. If you have multiple form components in a single form that have this property selected, the result is undefined.
|
|
Text area |
|
A text area with an optional leading label. The user input is saved to a variable. |
Properties: |
-
Help text [Help]
If a text is entered into this property, a tooltip label with a help icon will be created on the right side of the form component that will display the help text when the user hovers with the mouse above the icon. The text can be plain text or HTML. For multi-line labels, use HTML like this: <html>This is line one<br>This is line two</tt>.
-
Text [Label]
The text of the label. Can be empty. To configure a keyboard shortcut, prefix the mnemonic character in the label text with &, e.g."&User". The prefixed character will be underlined and the platform-specific keyboard shortcut (e.g. ALT+[character] on Windows) will allow the user to quickly navigate to this form component with the keyboard.
-
Icon [Label]
An image file with an icon for the label. Can be empty.
-
Icon-text gap [Label]
The gap between the label icon and the label text in pixels.
-
Font color [Label]
The color of the label font. If empty, the default color will be used.
-
Font [Label]
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Initial text [Text area]
The initial text in the text field. Can be empty.
-
Prevent empty user input [Text area]
If selected, empty user input is not accepted and a default error message is shown in that case. This is a quick validation option so that you do not have to validate user input in the validation script of the form screen, as it would be necessary for more complex validations.
-
Font [Text area]
The font of the text field. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Text area columns [Text area]
The width of the text area, expressed as a multiple of the width of the character 'm'. If zero, the text area will fill the entire horizontal space.
-
Text area rows [Text area]
The height of the text area, expressed as a multiple of line heights. Must be greater than zero.
-
Fill extra vertical space [Text area]
If set, the form component will expand to fill remaining vertical space. Extra vertical space is only available, if the form is not scrollable. Custom form screens have a "Scrollable" property, which must be set to false.
-
Wrap lines [Text area]
If selected, lines will wrap at the end of the text area. Otherwise a horizontal scroll bar will be show when needed.
-
Wrap entire words [Text area]
This property is only relevant when lines are wrapped. If set, lines will wrap on word boundaries if possible.
-
Use label font [Text area]
If selected, the default label font is used and other font settings are ignored.
-
Variable name [User input]
The name of the variable to which the user input is assigned. The type of the variable value is java.lang.String
-
Key validation expression [User input]
An expression or script that validates each key that is pressed in this component by the user.
-
Input validation expression [User input]
An expression or script that validates the user input when the text area loses the focus. If the expression returns false, the focus remains in the text area. In that case you should display an error message.
-
Request focus [User input]
If selected, the form component will request the focus after the form is activated. If you have multiple form components in a single form that have this property selected, the result is undefined.
|
|
Text field |
|
A text field with an optional leading label. The user input is saved to a variable. |
Properties: |
-
Help text [Help]
If a text is entered into this property, a tooltip label with a help icon will be created on the right side of the form component that will display the help text when the user hovers with the mouse above the icon. The text can be plain text or HTML. For multi-line labels, use HTML like this: <html>This is line one<br>This is line two</tt>.
-
Text [Label]
The text of the label. Can be empty. To configure a keyboard shortcut, prefix the mnemonic character in the label text with &, e.g."&User". The prefixed character will be underlined and the platform-specific keyboard shortcut (e.g. ALT+[character] on Windows) will allow the user to quickly navigate to this form component with the keyboard.
-
Icon [Label]
An image file with an icon for the label. Can be empty.
-
Icon-text gap [Label]
The gap between the label icon and the label text in pixels.
-
Font color [Label]
The color of the label font. If empty, the default color will be used.
-
Font [Label]
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Initial text [Text field]
The initial text in the text field. Can be empty.
-
Prevent empty user input [Text field]
If selected, empty user input is not accepted and a default error message is shown in that case. This is a quick validation option so that you do not have to validate user input in the validation script of the form screen, as it would be necessary for more complex validations.
-
Font [Text field]
The font of the text field. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Text field columns [Text field]
The width of the text field, expressed as a multiple of the width of the character 'm'. If zero, the text field will fill the entire horizontal space.
-
Variable name [User input]
The name of the variable to which the user input is assigned. The type of the variable value is java.lang.String
-
Key validation expression [User input]
An expression or script that validates each key that is pressed in this component by the user.
-
Input validation expression [User input]
An expression or script that validates the user input when the text field loses the focus. If the expression returns false, the focus remains in the text field. In that case you should display an error message.
-
Enter goes to next screen [User input]
If selected, hitting the ENTER key while the text field is focused, will go to the next screen, just as if the user had clicked on the "Next" button.
-
Request focus [User input]
If selected, the form component will request the focus after the form is activated. If you have multiple form components in a single form that have this property selected, the result is undefined.
|
|
Text field with date format |
|
A text field with an optional leading label and a date format. The user input (a java.util.Date) is saved to a variable. |
Properties: |
-
Date format [Format]
The date format specifies the components of the date that should be editable, i.e. date, time or date and time.
-
Date display style [Format]
The date display style specifies the verbosity of the date component.
-
Time display style [Format]
The time display style specifies the verbosity of the time component.
-
Initial value [Format]
The initial date in the text field.
-
Help text [Help]
If a text is entered into this property, a tooltip label with a help icon will be created on the right side of the form component that will display the help text when the user hovers with the mouse above the icon. The text can be plain text or HTML. For multi-line labels, use HTML like this: <html>This is line one<br>This is line two</tt>.
-
Text [Label]
The text of the label. Can be empty. To configure a keyboard shortcut, prefix the mnemonic character in the label text with &, e.g."&User". The prefixed character will be underlined and the platform-specific keyboard shortcut (e.g. ALT+[character] on Windows) will allow the user to quickly navigate to this form component with the keyboard.
-
Icon [Label]
An image file with an icon for the label. Can be empty.
-
Icon-text gap [Label]
The gap between the label icon and the label text in pixels.
-
Font color [Label]
The color of the label font. If empty, the default color will be used.
-
Font [Label]
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Font [Text field]
The font of the text field. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Text field columns [Text field]
The width of the text field, expressed as a multiple of the width of the character 'm'. If zero, the text field will fill the entire horizontal space.
-
Variable name [User input]
The name of the variable to which the user input is assigned. The type of the variable value is java.util.Date
-
Key validation expression [User input]
An expression or script that validates each key that is pressed in this component by the user.
-
Input validation expression [User input]
An expression or script that validates the user input when the text field loses the focus. If the expression returns false, the focus remains in the text field. In that case you should display an error message.
-
Enter goes to next screen [User input]
If selected, hitting the ENTER key while the text field is focused, will go to the next screen, just as if the user had clicked on the "Next" button.
-
Request focus [User input]
If selected, the form component will request the focus after the form is activated. If you have multiple form components in a single form that have this property selected, the result is undefined.
|
|
Text field with format mask |
|
A text field with an optional leading label and an arbitrary format mask. The user input is saved to a variable. The default mask is that of an SSN. For more information, please see the javadoc of javax.swing.text.MaskFormatter. |
Properties: |
-
Input mask [Format]
The input mask as defined be the javadoc of javax.swing.text.MaskFormatter.
-
Placeholder character [Format]
The character that is displayed for empty characters of the input mask that still have to be filled out by the user.
-
Valid characters [Format]
If not empty, this string defines the characters that are valid for user input.
-
Invalid characters [Format]
If not empty, this string defines the characters that are invalid for user input.
-
Allow invalid input [Format]
If set, invalid input will be allowed during editing. When the text field loses focus, invalid input will not be accepted, so the final value is guaranteed to be valid in any case.
-
Return literal characters [Format]
If set, the value that is saved to the variable contains literal characters defined in the input mask.
-
Help text [Help]
If a text is entered into this property, a tooltip label with a help icon will be created on the right side of the form component that will display the help text when the user hovers with the mouse above the icon. The text can be plain text or HTML. For multi-line labels, use HTML like this: <html>This is line one<br>This is line two</tt>.
-
Text [Label]
The text of the label. Can be empty. To configure a keyboard shortcut, prefix the mnemonic character in the label text with &, e.g."&User". The prefixed character will be underlined and the platform-specific keyboard shortcut (e.g. ALT+[character] on Windows) will allow the user to quickly navigate to this form component with the keyboard.
-
Icon [Label]
An image file with an icon for the label. Can be empty.
-
Icon-text gap [Label]
The gap between the label icon and the label text in pixels.
-
Font color [Label]
The color of the label font. If empty, the default color will be used.
-
Font [Label]
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Initial text [Text field]
The initial text in the text field. Can be empty.
-
Prevent empty user input [Text field]
If selected, empty user input is not accepted and a default error message is shown in that case. This is a quick validation option so that you do not have to validate user input in the validation script of the form screen, as it would be necessary for more complex validations.
-
Font [Text field]
The font of the text field. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Text field columns [Text field]
The width of the text field, expressed as a multiple of the width of the character 'm'. If zero, the text field will fill the entire horizontal space.
-
Variable name [User input]
The name of the variable to which the user input is assigned. The type of the variable value is java.lang.String
-
Key validation expression [User input]
An expression or script that validates each key that is pressed in this component by the user.
-
Input validation expression [User input]
An expression or script that validates the user input when the text field loses the focus. If the expression returns false, the focus remains in the text field. In that case you should display an error message.
-
Enter goes to next screen [User input]
If selected, hitting the ENTER key while the text field is focused, will go to the next screen, just as if the user had clicked on the "Next" button.
-
Request focus [User input]
If selected, the form component will request the focus after the form is activated. If you have multiple form components in a single form that have this property selected, the result is undefined.
|
|
Text field with integer format |
|
A text field with an optional leading label and an integer format. The user input is saved to a variable with type java.lang.Long. |
Properties: |
-
Minimum number of digits [Format]
The minimum number of digits that are acceptable for user input.
-
Maximum number of digits [Format]
The maximum number of digits that are acceptable for user input. If zero, there is no limit.
-
Use grouping separator [Format]
If set, a locale-dependent grouping separator is displayed.
-
Allow invalid input [Format]
If set, invalid input will be allowed during editing. When the text field loses focus, invalid input will not be accepted, so the final value is guaranteed to be valid in any case.
-
Help text [Help]
If a text is entered into this property, a tooltip label with a help icon will be created on the right side of the form component that will display the help text when the user hovers with the mouse above the icon. The text can be plain text or HTML. For multi-line labels, use HTML like this: <html>This is line one<br>This is line two</tt>.
-
Text [Label]
The text of the label. Can be empty. To configure a keyboard shortcut, prefix the mnemonic character in the label text with &, e.g."&User". The prefixed character will be underlined and the platform-specific keyboard shortcut (e.g. ALT+[character] on Windows) will allow the user to quickly navigate to this form component with the keyboard.
-
Icon [Label]
An image file with an icon for the label. Can be empty.
-
Icon-text gap [Label]
The gap between the label icon and the label text in pixels.
-
Font color [Label]
The color of the label font. If empty, the default color will be used.
-
Font [Label]
The font of the label. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Initial text [Text field]
The initial text in the text field. Can be empty.
-
Prevent empty user input [Text field]
If selected, empty user input is not accepted and a default error message is shown in that case. This is a quick validation option so that you do not have to validate user input in the validation script of the form screen, as it would be necessary for more complex validations.
-
Font [Text field]
The font of the text field. If empty, the default font is used. Use the font name "dialog" for the default label font and a "0" size value for the default size.
-
Text field columns [Text field]
The width of the text field, expressed as a multiple of the width of the character 'm'. If zero, the text field will fill the entire horizontal space.
-
Variable name [User input]
The name of the variable to which the user input is assigned. The type of the variable value is java.lang.Long
-
Key validation expression [User input]
An expression or script that validates each key that is pressed in this component by the user.
-
Input validation expression [User input]
An expression or script that validates the user input when the text field loses the focus. If the expression returns false, the focus remains in the text field. In that case you should display an error message.
-
Enter goes to next screen [User input]
If selected, hitting the ENTER key while the text field is focused, will go to the next screen, just as if the user had clicked on the "Next" button.
-
Request focus [User input]
If selected, the form component will request the focus after the form is activated. If you have multiple form components in a single form that have this property selected, the result is undefined.
|
|
|