Formatting (Converter)

With the converter wizard, you can assign formatting to the UI components. At runtime, the values displayed by the UI component are automatically formatted according to the assigned formats. The formatting, e.g. a currency symbol, only changes the display of the value. In the majority of cases, the value itself is not affected by the formatting, e.g. $ or €. However, an exception to this is the use of the % formatting, which also changes the value according to the percentage applied.

Parameters:

• None - The value is displayed without formatting.
• Number -
  • Type - Converts the value in the selected data type
  • locale   - Uses a country-specific notation (localization). In Default the locale of the client is used.
  • Format >
    
    • Number - Formats the value as a number. 
    • Currency - Refers to the locale selected in Number and formats the value with the appropriate currency. 
    • Percent   - Multiplies the value by 100 to convert it into a percentage and adds the % sign. The value must be available in decimal form (e.g 0.1) to be correctly displayed as a percentage (10%).
  • Grouping used - 
  • Minimum integer digits - Represents the minimum value with the indicated digits. Smaller values are filled with zeros, e.g.   000125.
  • Maximum integer digits - Represents the maximum value with the indicated digits. Additional decimals are truncated.
  • Minimum fraction digits - Represents the minimum value with the indicated decimal places.
  • Maximum fraction digits - Represents the maximum value with the indicated decimal places. Additional decimal places are truncated.
  • Rounding mode - Rounds the value according to the setting UP, DOWN, CEILING, FLOOR, HALF-UP, HALF-DOWN, HALF-EVEN, UNNECESSARY.
  • Decimal separator always shown   - Always shows a decimal point. 
  • Grouping size -
  • Multiplier - Multiplies the value by the specified value.
  • Negative prefix - Adds the specified prefix if the value is negative.
  • Negative suffix - Adds the specified suffix if the value is negative.
  • Positive prefix - Adds the specified prefix if the value is positive.
  • Positive suffix - Adds the specified suffix if the value is positive.
• Date >
  • Locale - Uses a country-specific notation (localization). Under Default it uses the locale of the client.
  • Format >
    • Date + Time - Displays date and time.
    • Date - Displays only the date.
    • Time   - Displays only the time.
  • Date style - uses the specified notation for dates Default, Full, Long, Medium, Short.
  • Time style - uses the specified notation for time designations Default, Full, Long, Medium, Short.
  • Pattern - Formats the date according to the specified rules.
• Boolean - Replaces the Boolean values of true and false by the specified denominations, e.g. Yes and No.

UI components:

• XdevTable
• XdevTextField
• XdevTextArea
• XdevPopupDateField
• XdevInlineDateField