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.
  • 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 click the Open icon to 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. Click the Open condition builder icon to 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. Click the Open icon to 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.
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:
  • 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
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

See Using the currency control: Implementation

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 style drop-down controls 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 style drop-down controls.
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

  • 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.
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 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.

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 Thousands, a value of 20,000 appears as "20 K." If Percentage, the value appears as a percent sign (.8 appears as "80%").

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 Style Ref options. By default, the class name is NegativeNumber.

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.