Currency Properties — Presentation tab

Field

Description

• Auto— The control uses the edit mode of the section or harness in which it appears. If the section is set to Read Only, then the control is Read Only. If the section is set to Auto, then the control uses the edit mode of the harness. For example, a New harness is editable, while a Review harness is read only.
• Read only (always)— The control uses a property value from the control or another property value or a constant. From the automplete field select an existing property or clickto define a new property in the Create Property panel or enter a constant.
• Read only (expression)— The control uses a simple expression based on the comparison of a pair of constants, properties, or both, combined by Boolean operators, such as .Color="Red". You can combine the expression with a when condition rule or another expression using the && and || operators.
  As a best practice, use the Condition Builder to edit this field. Clickto open the tool. See Using the Condition Builder to configure dynamic UI actions.
• Read only (when rule)— The control uses the When Name key part of a when condition rule. Clickto review or create the rule.
• Editable— the control is editable, regardless of the edit mode of the enclosing layout. However, in this mode, the enhanced currency features are not available.

For Read-only formats, select to display one of the following:

• Display text of selected option— displays the description
• Property value— displays the value of the selected property
• Another property's value— displays the value of the property that you specify. In the field that displays, select the property for which you want to display the value.

Read-only options

The currency symbol can be determined by:

• Currency (standard currency symbol)— select the locale currency or specify another currency.
• Constant— select a predefined constant for another currency
• Reference— select a predefined reference for another currency

Select a property whose value contains the currency code. The currency code can either be the 3-letter alphabetic code (for example, USD) or the ISO code (for example, 840). In addition, you can use a hard-coded 3-letter alphabetic code or ISO code. For a list of all ISO and alphabetic codes refer to Currency Codes - ISO 4217

See Using the currency control: Implementation

Specifies how halfway values are handled:

Round to nearest even number— If whole number is even, round down; if whole number is odd, round up. (Commonly referred to as banker's rounding.) For example, 11.5 = 12, 12.5=12.

Round up to nearest— Always round up. For example, 11.5 = 12, 12.5 = 13.

Specifies the width of the text field and number of characters supported.

Select Auto if you want the layout to determine the width of the control area. This is the default. If you want to specify a fixed (pixel) or variable (percent) width for the text input, select Custom and then specify the width in pixels or percentage.

Optional. Enter a value that determines the minimum and maximum number of characters that can be entered in the text input. You can designate either value as unlimited by leaving it blank.

Specifies the format of the drop-down list. You can style drop-down controls and create additional formats in the skin rule. To select a custom format, press the down arrow and select Other.

Select a format (read-only) used with this property. Your selection filters the format options: Email, Number, Telephone, Text, URL.

Do not confuse format types with property types.

Appears if Type is Number.

Select left, right, or center alignment.

Appears if Type is Number. When a symbol is specified an additional character(s) is prepended to the value. Currency automatically uses the localized currency symbol, constant uses a string, and reference uses a property value.

Select an option for representing the number as

• Currency — Formats the number as a currency using the default locale.
• Constant — A text string or character (for example, "%") ASCII character that you enter.
• Reference — A property value.

Appears if Type is Number.

A non-negative integer to control the number of digits presented after the decimal place. The default is Auto, which displays a maximum of three decimal places (placeholder zeroes are not added). Select to remove all digits after the decimal point and round to the nearest integer. Select All to include all digits.

Appears if Type is Number.

Select a label indicating the scaling you wish to apply to the number: percentage or order of magnitude. For example, if you select Thousands, a value of 20,000 appears as "20 K." If Percentage, the value appears as a percent sign (.8 appears as "80%").

Appears if the Type is Number.

Select a format (minus sign or parenthesis) for displaying negative numbers.

You can also specify a CSS class if you select one of the Style Ref options. By default, the class name is NegativeNumber.

Check this option to display validation errors to users at runtime. When enabled for auto-generated controls in read-only mode, if the control's validation fails, the validation message displays to the user. This option is available in the Presentation tab under Read-only Format. It is also available in the control ruleform. When enabled on the control ruleform, all controls using that ruleform will have the option enabled. Show validation messages in read-only mode is disabled by default.

Appears if Type is Number.

Select to use a thousands separator. Depending upon the default locale, a comma or period is used.

Advanced Presentation Options