Installer - Available Form Components

## Installer - Available Form Components |

| Category: Action components
Button
A standard button with an optional leading label. When the user clicks on the button, an action script is executed.
Properties:
Button text [Button] The text that is displayed on the button. Can be empty if the button icon is set. Button icon [Button] The icon displayed on the button. Can be empty if the button text is set. Action script [Button] The script that is executed when the button is clicked by the user. The return type is `void`. 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. 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.
Hyperlink URL label
A label that displays a hyperlink. When the user clicks on the hyperlink, the appropriate action is performed, depending on the protocol of the URL.
Properties:
Hyperlink text The text that is displayed on the hyperlink label. URL The URL for the hyperlink. For example `http://www.ej-technologies.com` 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. 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.
Hyperlink action label
A label that displays a hyperlink. When the user clicks on the hyperlink, an action script is executed
Properties:
Hyperlink text The text that is displayed on the hyperlink label. Action script The script that is executed when the hyperlink is clicked by the user. The return type is `void`. 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. 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.

| Category: Labels and spacers
Horizontal separator
A horizontal separator with an optional label.
Properties:
Text [Label] The text of the label. Can be empty. 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. Use special title font [Label] If selected, a special font and color are used for the separator label. The actual font depends on the look and feel. This setting overrides all other font settings for the label.
Key value pair label
A pair of labels. The first ('key') label aligns with other leading labels on the form, the second ('value') label consumes the remaining horizontal space,
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 [Key Label] The text of the key label. Can be empty. Icon [Key Label] An image file with an icon for the key label. Can be empty. Icon-text gap [Key Label] The gap between the key label icon and the key label text in pixels. Font color [Key Label] The color of the key label font. If empty, the default color will be used. Font [Key Label] The font of the key 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. Text [Value Label] The text of the value label. Can be empty. Icon [Value Label] An image file with an icon for the value label. Can be empty. Icon-text gap [Value Label] The gap between the value label icon and the value label text in pixels. Font color [Value Label] The color of the value label font. If empty, the default color will be used. Font [Value Label] The font of the value 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.
Label
A single label.
Properties:
Text [Label] The text of the label. Can be empty. 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.
Multi-line HTML label
A multi-line label that wraps text as needed and displays simple HTML. In particular you can include HTML links that open a browser.
Properties:
HTML [Label] The HTML for the label. The value should start with <html>, otherwise the plain text will be displayed. You can include HTML links that open a browser when clicked by the user. URLs in <a href="..."> links should start with `http://` or `file://`.
Multi-line label
A multi-line label that wraps text as needed.
Properties:
Text [Label] The text of the label. 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.
Spring
An invisible spring that can be used in horizontal and vertical layout groups to push subsequent components to the right or to the bottom
Properties:
Axis The direction along which the spring will push subsequent components. In a horizontal layout group, use the "Horizontal" setting, in a vertical layout group, use the "Vertical" setting.
Vertical spacer
An invisible vertical spacer of configurable height.
Properties:
Spacer height The height of the spacer in pixels. The spacer itself is invisible.

| Category: Option selectors
Check box
A check box with an optional leading label. The user selection (`Boolean.TRUE` or `Boolean.FALSE`) is saved to a variable.
Properties:
Text [Check box] The text of the check box. Can be empty. Initially selected [Check box] If set, the check box is initially selected Selection script [Check box] The script that is executed when the selection state of the check box is changed by the user. The return type is `void`. Coupled components You can select other components on the same form screen which are enabled only if the check box is selected. Inverse coupling If set, the coupling of other form components will be inverted with respect to the selection state of the check box. 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. Variable name [User input] The name of the variable to which the user input is assigned. The variable value will be one of `Boolean.TRUE` or `Boolean.FALSE`, depending on the user selection.The type of the variable value is `java.lang.Boolean` 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.
Combo box
A combo box with an optional leading label. The user can enter arbitrary text into the combo box. The user selection (the selected item as a string) is saved to a variable.
Properties:
Combo box entries [Combo box] The items in the combo box as a list separated by semicolons. The items in the list must be separated by semicolons. If you click on the edit button in the property editor, you can enter one item per line in a separate dialog. Items that are installer variables with array values (e.g. String[], Object[] or File[]) are expanded as separate items, this allows you to build a variable length list of items at runtime. Initially selected index [Combo box] The zero-based index of the initially selected item in the combo box.If you would like to compute this value at runtime, please set the bound variable to a `java.lang.Integer` value before this screen is shown. Fill horizontal space [Combo box] If set, the combo box will fill all the available horizontal space, otherwise it will be as wide as required for the the widest item. 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. Variable name [User input] The name of the variable to which the user input is assigned. The variable value will be the selected item text.The type of the variable value is `java.lang.String` Selection change script [User input] A script that is executed when the selection is changed by the user. This script is only required for advanced customizations of the form screen. The return type is `void`. Input validation expression [User input] An expression or script that validates the user input when the combo box loses the focus. If the expression returns false, the focus remains in the combo box. 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.
Drop-down list
A drop-down list with an optional leading label. The user selection (the selected index as a `java.lang.Integer`) is saved to a variable.
Properties:
Drop-down list entries [Drop-down list] The items in the drop-down list as a list separated by semicolons. The items in the list must be separated by semicolons. If you click on the edit button in the property editor, you can enter one item per line in a separate dialog. Items that are installer variables with array values (e.g. String[], Object[] or File[]) are expanded as separate items, this allows you to build a variable length list of items at runtime. Initially selected index [Drop-down list] The zero-based index of the initially selected item in the drop-down list.If you would like to compute this value at runtime, please set the bound variable to a `java.lang.Integer` value before this screen is shown. Fill horizontal space [Drop-down list] If set, the drop-down list will fill all the available horizontal space, otherwise it will be as wide as required for the the widest item. 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. Variable name [User input] The name of the variable to which the user input is assigned. The variable value will be the index of the selected item.The type of the variable value is `java.lang.Integer` Selection change script [User input] A script that is executed when the selection is changed by the user. This script is only required for advanced customizations of the form screen. The return type is `void`. 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.
List
A list with an optional leading label. The user selection (the selected indices) 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. List entries [List] The items in the list as a list separated by semicolons. The items in the list must be separated by semicolons. If you click on the edit button in the property editor, you can enter one item per line in a separate dialog. Items that are installer variables with array values (e.g. String[], Object[] or File[]) are expanded as separate items, this allows you to build a variable length list of items at runtime. Initially selected index [List] The zero-based index of the initially selected item in the list.If you would like to compute this value at runtime, please set the bound variable to a `java.lang.Integer` value before this screen is shown. Fill horizontal space [List] If set, the list will fill all the available horizontal space, otherwise it will be as wide as required for the the widest item. Visible rows [List] If the list is scrollable, this property determines the height of the list. Fill extra vertical space [List] 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. Scrollable [List] If set, the list will be wrapped in a scroll pane. Multi-selection [List] If set, the user can select multiple entries at the same time. Variable name [User input] The name of the variable to which the user input is assigned. If multiple items can be selected, the variable value will be an `int[]` array with the selected indices, otherwise the variable value will be the index of the selected item as a `java.lang.Integer` Selection change script [User input] A script that is executed when the selection is changed by the user. This script is only required for advanced customizations of the form screen. The return type is `void`. 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.
Radio button group
A number of radio buttons in a common button group with an optional leading label. The user selection (the selected index as a `java.lang.Integer`) 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. 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. Radio button labels [Radio buttons] The labels of all the radio buttons as a list separated by semicolons. Initially selected index [Radio buttons] The zero-based index of the initially selected radio button. If you would like to compute this value at runtime, please set the bound variable to a `java.lang.Integer` value before this screen is shown. Axis [Radio buttons] The direction along which the radio buttons will be laid out. Variable name [User input] The name of the variable to which the user input is assigned. The variable value will be the index of the selected radio button.The type of the variable value is `java.lang.Integer`
Single radio button
A single radio button with an optional leading label. If selected, a specified string is saved to a variable. If you place multiple instances of this form component on a form screen and give them the same variable name, they will form a radio button group.
Properties:
Coupled components You can select other components on the same form screen which are enabled only if the radio button is selected. Inverse coupling If set, the coupling of other form components will be inverted with respect to the selection state of the radio button. 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. Radio button label [Radio button] The text of the radio button. Initially selected [Radio button] If selected, the radio button will be initially selected. Selection script [Radio button] The script that is executed when the radio button is selected by the user. The return type is `void`. Variable name [User input] The name of the variable to which the user input is assigned. The variable value will be the string defined in the "Variable value" property.The type of the variable value is `java.lang.String` Variable value [User input] The value that should be written to the variable if this radio button is selected. 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.

| Category: Sliders and spinners
Slider
A slider with an optional leading label. The user input (a `java.lang.Integer`) 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. Minimum value [Slider] The minimum value on the left side of the slider. Maximum value [Slider] The maximum value on the right side of the slider. Initial value [Slider] The initial value of the slider. Major tick spacing [Slider] The spacing between major ticks expressed as a value. Minor tick spacing [Slider] The spacing between minor ticks expressed as a value. Snap to ticks [Slider] If set, the user selection is snapped to the closest tick value. 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.Integer` 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.
Spinner of dates
A spinner with date and time values 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. Date format pattern [Spinner] A pattern to format dates for display and input as described in the javadoc of `java.text.SimpleDateFormat`. An example is `yyyy.MM.dd 'at' HH:mm:ss z`. If empty, a locale-dependent default pattern with date and time components will be used. Initial value [Spinner] The initial value of the spinner. 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` 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.
Spinner of enumerated values
A spinner with enumerated values 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. List entries [Spinner] The items in the spinner. The items in the list must be separated by semicolons. If you click on the edit button in the property editor, you can enter one item per line in a separate dialog. List items that are installer variables with array values (e.g. String[], Object[] or File[]) are expanded as separate list items, this allows you to build a variable length list of list items at runtime. Initially selected index [Spinner] The zero-based index of the initially selected item in the spinner. 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` 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.
Spinner of integer values
A spinner with integer values 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. Minimum value [Spinner] The minimum value on the left side of the spinner. Maximum value [Spinner] The maximum value on the right side of the spinner. Initial value [Spinner] The initial value of the spinner. Step size [Spinner] The step size for the spinner. 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.Integer` 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.

| Category: Special selectors and displays
Directory chooser
A directory chooser with an optional leading label. The user selection is saved to a variable.
Properties:
Allow new folder creation [Chooser Dialog] If selected, the directory chooser that is displayed with the chooser button will feature a button to create new directories. Manual entry allowed [Chooser Dialog] If selected, the user can enter the directory manually in the text field. Otherwise, the text field is disabled. Initial directory [Directory chooser] The initially selected directory. Can be empty. 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. Allow spaces in directory name [Unix] If selected, spaces are valid characters in the installation directory name for Unix/Linux installers, otherwise an error message is displayed if the user chooses a directory with spaces in it. Some JREs do no work on Unix if installed to a path that contains spaces, so spaces are disallowed by default. 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` Validation script [User input] The script that is executed when the directory is selected with the chooser button. If the script returns true, the selection is accepted, if it returns false, the selection is discarded. 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.
File chooser
A file chooser with an optional leading label. The user selection is saved to a variable.
Properties:
Manual entry allowed [Chooser Dialog] If selected, the user can enter the file manually in the text field. Otherwise, the text field is disabled. Initial file [File chooser] The initially selected file. Can be empty. Use file filter [File chooser] If a file filter should be used. Configure the file filter in the nested properties once you enable this option. File filter name The name of the file filter. If empty, all files are selectable. Note: This property is only visible if "Use file filter" is selected. Filtered file extension The list of the filtered file extension. If empty, all files are selectable. The items in the list must be separated by semicolons. If you click on the edit button in the property editor, you can enter one item per line in a separate dialog. File extensions that are installer variables with array values (e.g. String[], Object[] or File[]) are expanded as separate file extensions, this allows you to build a variable length list of file extensions at runtime. Note: This property is only visible if "Use file filter" is selected. 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. 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` Validation script [User input] The script that is executed when the file is selected with the chooser button. If the script returns true, the selection is accepted, if it returns false, the selection is discarded. 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.
HTML display
A scroll panel that displays HTML text. The HTML is easily localizable since the file selection allows you to enter separate files for all supported languages.
Properties:
Text source [HTML display] The source from which the text is loaded. For multi-language installers, the "File" source is recommended since it is more easily localizable than the direct entry. Text file The file from which the text is loaded. Note: This property is only visible if "Text source" is set to "File". Text The text that is displayed in the screen, either plain text or HTML. For HTML, the value should start with , otherwise the plain text will be displayed. The text is displayed in a scrollable text area. Note: This property is only visible if "Text source" is set to "Direct". Height [HTML display] The height of the HTML display in pixels. Fill extra vertical space [HTML display] 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. 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. 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.
Installation directory chooser
An installation directory chooser with an optional display of required and free space. The user selection is set as the installation directory.
Properties:
Suggest application directory [Application ID] When the user chooses a directory, always append the default application directory configured in the media file wizard. You should only switch this off if you substitute a different installation directory in the screen validation. Existing directory warning [Application ID] Ask the user whether to install the application in the selected directory if it already exists and the installation is not an update. Validate application id [Application ID] Check if another application is installed in the selected directory or if the application is not the correct target for an add-on installer. Allow new folder creation [Chooser Dialog] If selected, the directory chooser that is displayed with the chooser button will feature a button to create new directories. Manual entry allowed [Chooser Dialog] If selected, the user can enter the installation directory manually in the text field. Otherwise, the text field is disabled. Insufficient disk space warning [Disk Space] Show a warning message if there is not sufficient disk space for the installation on the selected target drive. Show required disk space [Disk Space] Show the disk space that is required for the installation. You should switch this off if your installation includes other data sources. Show free disk space [Disk Space] Show the disk space that is available on the selected drive or partition. This setting is only effective for Windows, Mac OS X and Linux. 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. Allow spaces in directory name [Unix] If selected, spaces are valid characters in the installation directory name for Unix/Linux installers, otherwise an error message is displayed if the user chooses a directory with spaces in it. Some JREs do no work on Unix if installed to a path that contains spaces, so spaces are disallowed by default. Validation script [User input] The script that is executed when the installation directory is selected with the chooser button. If the script returns true, the selection is accepted, if it returns false, the selection is discarded. 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.
Progress display
An progress display that can show the progress of the actions attached to the containing screen.
Properties:
Hide initially If selected, the progress bar is hidden when the form is shown. When the actions attached to the screen are executed, the progress bar is made visible. Status line visible If selected, the status line is visible. Detail line visible If selected, the detail line is visible.
Update schedule selector
Drop-down box that lets the user select an update schedule for your application. You can use the `com.install4j.api.update.UpdateScheduleRegistry` class in your application to check if you should launch an updater. Please see the Javadoc for more information. Please note that simply adding this form component does not automatically launch an updater at regular intervals.
Properties:
Initial update schedule The initially selected update schedule. If the user has already installed the application before, the currently active selection by the user will be selected and this value will be ignored. 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. 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.
Windows user selector
A component for selecting Windows users or groups in the native Windows user dialog. Optionally, you can display a button to create a new user. The selection is saved as a SID to a string variable. If multiple selection is enabled, the result is a string array of SIDs. This component does not do anything in console mode, since it requires the native Windows dialog for selecting users and groups.
Properties:
Show users Show users in the native user selection dialog. Show groups Show users in the native user selection dialog. Show well-known principals Show well-known principals like "SYSTEM" or "SERVICE" in the native user selection dialog. Multiple selection If selected, multiple users or groups can be selected. The variable type is a string array of SIDs in that case, otherwise it is a string with the single selected SID. Multiple selection cannot be combined with the "Create User" option. Only local objects If selected, only local users and groups will be displayed. Show "Create User" button If selected, a button to create a new user will be displayed next to the "Browse" button. On clicking that button, a separate dialog will be shown where the new user can be configured. Note: This property is only visible if "Show users" is selected. Variable for user creation flag The name of the variable which will be set to `Boolean.TRUE` if the selected user has been created by the user. If the selected user has not been created, the variable value will be set to `Boolean.FALSE`. This is useful if you would like to determine if the uninstaller should delete the user. Users can be deleted with the install4j API. This variable name can be empty, in which case the creation status will not be saved. Note: This property is only visible if "Show "Create User" button" is selected. Variable for local group The name of the variable which will be set to the local group used for a newly created user. This variable name can be empty, in which case the created local group name will not be saved. Note: This property is only visible if "Show "Create User" button" is selected. Variable for group creation flag The name of the variable which will be set to `Boolean.TRUE` if a group for the selected user has been created by the user. If the selected user has not been created or if an existing group was used, the variable value will be set to `Boolean.FALSE`. This is useful if you would like to determine if the uninstaller should delete the local group. Groups can be deleted with the install4j API. This variable name can be empty, in which case the creation status will not be saved. Note: This property is only visible if "Show "Create User" button" is selected. Password form component A text field or password field form component that should be updated with the password that was chosen for the created user.If not selected, no such update will be performed. Note: This property is only visible if "Show "Create User" button" is selected. 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. 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. Variable name [User input] The name of the variable to which the user input is assigned. The variable value will be a string with the selected SID, or, if multiple selection is enabled, a string array of SIDs.

| 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.

Console handler
Allows you to interact with the user in a console installer. All standard form components expose appropriate behavior in console mode, however, there are situations where you need to fine-tune your console installer with additional messages or questions. In GUI or unattended mode, this form component does not have any effect.
Properties:
Console script The script that is executed in console mode. The "console" parameter gives you access to the console and many helper methods. The return type is boolean and indicates whether the installer should be cancelled or not.