Currency Properties – Presentation tab
Click the View properties icon in the currency control to display the Currency cell properties panel, and then select the Presentation tab.
A read-only edit option is required to display a different currency than the locale currency. See Using the Currency Control.
Presentation tab
Field | Description |
Edit Options | Select an edit mode for this control. The edit mode of the control, specified
here, takes precedence over section and harness settings.
|
Read-only value | |
Control format | Read-only option. Specifies the style format applied to the currency control. You can define multiple formats in the skin rule. Press the down arrow to select another format, if applicable. |
Label format | Read-only option. Specifies the format of the currency control's label. |
Read-only options | |
Type | Always use Number for currency. |
Text alignment | Currency alignment: Right (default) or Left. |
Symbol | The currency symbol can be determined by:
|
Other 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 |
Currency position | Determines if the currency text is displayed using the locale default or (to override) left or right of the number. For example: USD $1.00 or $1.00 USD. |
Display currency as | Determines whether to display the currency name, 3-character code, or currency symbol. |
Decimal places | Specifies the number of digits displayed after the currency unit (default is 2 decimal places). |
Rounding Methods | 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. |
Separators | Specify whether or not to use numeric separators. (The type of separator - commas, periods, and spaces, etc. - are determined by the locale settings.) |
Scale | Specifies whether the numbers represent a percentage or a standard multiple (thousand, million, etc.) |
Negative Format | Specifies how a negative number is represented using a minus or parentheses or a reference - or some combination of these. |
Editable options | |
Specify Size | 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. |
Min/Max Chars | 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. |
Control format | Specifies the format of the drop-down list. You can Skin form — Components tab — Controls — Dropdowns and create additional formats in the skin rule. To select a custom format, press the down arrow and select Other. |
Label format | Specifies the format of the drop-down labels. See Skin form — Components tab — Controls — Dropdowns |
Type | Select a format (read-only) used with this property. Your selection filters the format options: Email, Number, Telephone, Text, URL. |
Text Alignment | Appears if Type is Number. Select left, right, or center alignment. |
Symbol | 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
|
Decimal Places | Appears if Type is Number. A non-negative integer to control the number of digits presented after the
decimal place. The default is |
Scale | 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
|
Negative Format | 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 |
Show validation messages in read-only mode | |
Separators | 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
Instead of creating a new custom format in the skin, you can adjust elements in a cell by applying Cascading Style Sheet (CSS) helper classes. For example, you can use a CSS helper class to center an element in a cell or to double the standard right margin for the element.
- Cell read-write classes – Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-write mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
- Cell read-only classes– Click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in read-only mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell.
- Inline style (not for production use) – You can use this field to define an inline style by entering CSS code. However, entering an inline style results in a guardrail warning. For maintainability and reuse, the recommended approach is to use read-write or read-only classes.
- Using the Currency Control
The autogenerated control can display a selected currency using its symbol, code, full name, or ISO code. However, for readability, the decimal separator and thousands separator come from the locale. In addition, if the currency is displayed as a 3-digit code, it can show the ISO code before or after the amount (and optionally delimited by a forwa
Previous topic Purpose-Specific Control— General tab Next topic Using the Currency Control