|
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.
|
Minimum Java requirement: 1.4 |
Properties: |
-
Allow invalid input
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.
-
Text field columns
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.
-
Icon-text gap
The gap between the label icon and the label text in pixels.
-
Initial text
The initial text in the text field. Can be empty.
-
Input mask
The input mask as defined be the javadoc of javax.swing.text.MaskFormatter.
-
Input validation expression
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.
-
Invalid characters
If not empty, this string defines the characters that are invalid for user input.
-
Key validation expression
An expression or script that validated each key that is pressed in this component by the user.
-
Font color
The color of the label font. If empty, the default color will be used.
-
Font
The font of the label. If empty, the default font is used.
-
Icon
An image file with an icon for the label. Can be empty.
-
Text
The text of the label. Can be empty.
-
Placeholder character
The character that is displayed for empty characters of the input mask that still have to be filled out by the user.
-
Font
The font of the text field. If empty, the default font is used.
-
Valid characters
If not empty, this string defines the characters that are valid for user input.
-
Return literal characters
If set, the value that is saved to the variable contains literal characters defined in the input mask.
-
Variable name
The name of the variable to which the user input is assigned. The type of the variable value is java.lang.String.
|
|