Start changeData Format tags

When a tag is editable, the following tags allow you to specify the data type permitted by the user:

<SHORT[minvalue="value1"] [maxvalue="value2"]/>
NAME VALUE DESCRIPTION
<SHORT> short Specifies that the value in the text field must be a short that lies within the range value1-value2. Both the minvalue and maxvalue attributes are optional; if omitted, the value will be checked against the allowable range for short integers in Java.

<INTEGER[minvalue="value1"] [maxvalue="value2"]/>
NAME VALUE DESCRIPTION
<INTEGER> integer Specifies that the value in the text field must be an integer that lies within the range value1-value2. Both the minvalue and maxvalue attributes are optional; if omitted, the value will be checked against the allowable range for integers in Java.

<LONG[minvalue="value1"] [maxvalue="value2"]/>
NAME VALUE DESCRIPTION
<LONG> long Specifies that the value in the text field must be a long that lies within the range value1-value2. Both the minvalue and maxvalue attributes are optional; if omitted, the value will be checked against the allowable range for long integers in Java.

<FLOAT[minvalue="value1"] [maxvalue="value2"]/>
NAME VALUE DESCRIPTION
<FLOAT> float Specifies that the value in the text field must be a floating point number which must lie within the range value1-value2. Both the minvalue and maxvalue attributes are optional; if omitted, the value will be checked against the allowable range for the double data type in Java.

<STRING[minlength="value1"] [maxlength="value2"]/>
NAME VALUE DESCRIPTION
<STRING> string Specifies that the value in the text field must be a string whose length is within the range value1-value2. Both the minlength and maxlength attributes are optional, but at least one must be specified.

<FORMAT[minvalue="value1"] [maxvalue="value2"]/>
NAME VALUE DESCRIPTION
<FORMAT> format
where format may have one of the following values:
PERCENT
The data in the text field will be inspected to verify that it is a valid floating point value between 0.0 and 100.0.
DATE
The data in the text field will be inspected to verify that it contains a date that is formatted correctly for the current locale.
TIME
The data in the text field will be inspected to verify that it contains a time that is formatted correctly for the current locale.
INTERNETADDRESS
The data in the text field will be inspected to verify that it is a valid dotted decimal address.

If the data is found to be invalid according to the specified criteria, an appropriate error message will be displayed to the user.

Alternatively, format may specify the fully qualified name of a formatter class which will receive control when data is inserted into or extracted from the combo box. The class must extend the DataFormatter class. The framework will automatically create an object of the specified class, and call its format and parse methods to validate the data at the appropriate times.

Refer to the com.ibm.as400.ui.framework.java.DataFormatter package for more information.

A predefined format constant which specifies how the data in the text field should be interpreted when data is exchanged between the combo box component and its associated data object.
End change


[ Legal | AS/400 Glossary ]