|
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></html>. - 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. - Font color [Label]
The color of the label font. If empty, the default color will be used. - Font [Label]
The font type of the label. For a derived form, you can optionally change size, and font attributes, with a custom font you can also choose a different font face. - Font specification
The font specification for the label.Note: This property is only visible if "Font" is set to "Custom". - Font style
The font style of the label.Note: This property is only visible if "Font" is set to "Derived". - Font size in percent
The font size of the label in percent relative to the default font.Note: This property is only visible if "Font" is set to "Derived". - Icon [Label]
An image file with an icon for the labellabel. Can be empty.To add a high-resolution image for retina displays, create a file with double the resolution and an additional @2x after the name (e.g. image.png and image@2x.png) next to the selected image. The install4j runtime JAR file i4jruntime.jar contains a number of image files that you can reference here by prefixing the icon file name with "icon:". For example, icon:lock_open_32.png loads a 32x32 icon showing an open lock. - Icon-text gap [Label]
The gap between the label icon and the label text in pixels. - Initial text [Text field]
The initial text in the text field. The variable value takes precedence, so this value will only be used if the variable value is undefined. 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 type of the text field. For a derived form, you can optionally change size, and font attributes, with a custom font you can also choose a different font face. - Font specification
The font specification for the text field.Note: This property is only visible if "Font" is set to "Custom". - Font style
The font style of the text field.Note: This property is only visible if "Font" is set to "Derived". - Font size in percent
The font size of the text field in percent relative to the default font.Note: This property is only visible if "Font" is set to "Derived". - 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.The text parameter does not contain> the modifications of this key event. - Key listener script [User input]
A script that is executed each time that a key is pressed in this component by the user.The text parameter already contains the modification of this key event. - 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.
|
|