Longbox"
From Documentation
Jumperchen (talk | contribs) |
Jimmyshiau (talk | contribs) |
||
| Line 21: | Line 21: | ||
</window> | </window> | ||
</source> | </source> | ||
| + | =Properties= | ||
| + | == Format == | ||
| + | You are able to format the field by providing specifying the attribute with a formatting string. The default value is <tt>null</tt>. | ||
| + | |||
| + | <source lang="xml" > | ||
| + | <longbox format="#,##0"/> | ||
| + | </source> | ||
| + | |||
| + | == Constraints == | ||
| + | You could specify what value to accept for input controls by use of the <tt>constraint </tt>property. | ||
| + | It could be a combination of <tt>no positive</tt>, <tt>no negative</tt>, <tt>no zero</tt>, <tt>no empty</tt>. | ||
| + | |||
| + | To specify two or more constraints, use comma to separate them as follows. | ||
| + | |||
| + | <source lang="xml" > | ||
| + | <longbox constraint="no negative,no empty"/> | ||
| + | </source> | ||
| + | |||
| + | If you prefer to display different message to the default one, you can append the error message to the constraint with a colon. | ||
| + | |||
| + | <source lang="xml" > | ||
| + | <intbox constraint="no negative: it shall not be negative"/> | ||
| + | </source> | ||
| + | |||
| + | Notes: | ||
| + | * The error message, if specified, must be the last element and start with colon. | ||
| + | * To support multiple languages, you could use the 「l」 function as depicted in the '''Internationalization''' chapter. | ||
| + | |||
| + | <source lang="xml" > | ||
| + | <longbox constraint="no negative: ${c:l('err.age.negative')}"/> | ||
| + | </source> | ||
=Inherited Functions= | =Inherited Functions= | ||
Revision as of 22:15, 2 December 2010
Longbox
Employment/Purpose
A longbox is used to let users input long data.
Example
<window title="Longbox Demo" border="normal" width="400px">
long box:<longbox width="250px"/>
</window>
Properties
Format
You are able to format the field by providing specifying the attribute with a formatting string. The default value is null.
<longbox format="#,##0"/>
Constraints
You could specify what value to accept for input controls by use of the constraint property. It could be a combination of no positive, no negative, no zero, no empty.
To specify two or more constraints, use comma to separate them as follows.
<longbox constraint="no negative,no empty"/>
If you prefer to display different message to the default one, you can append the error message to the constraint with a colon.
<intbox constraint="no negative: it shall not be negative"/>
Notes:
- The error message, if specified, must be the last element and start with colon.
- To support multiple languages, you could use the 「l」 function as depicted in the Internationalization chapter.
<longbox constraint="no negative: ${c:l('err.age.negative')}"/>
Inherited Functions
Please refer to NumberInputElement for inherited functions.
Supported Events
| None | None |
- Inherited Supported Events: NumberInputElement
Supported Children
*NONE
Use Cases
| Version | Description | Example Location |
|---|---|---|
Version History
| Version | Date | Content |
|---|---|---|