Configure Currency (Money) Fields

Add a money control to your form to allow users to enter money amounts (USD, EUR, JPY, GBP, and INR). By default, the currency type is set to USD. The user can change the currency type using the Currency property on the General tab. The corresponding currency symbol displays next to the currency amount. Users can use commas or decimal point to enter different amounts into the control, such as £30,700.00. If users don’t specify commas or decimal point, the form automatically displays these symbols. The form rounds all currency amounts to two decimal places.

To configure a money control:
  1. From the Advanced palette, drag the Money control onto the canvas.
  2. Select the control and use the General tab in the Properties pane to configure the following:
    Field Description

    Name

    An internal identifier that you will use to identify the control.

    Label

    Specifies the name that displays to users.

    Binding

    Defines a link between the control and a data attribute.

    Currency

    Allows you to change the currency type.

    Default Value

    The default value that will appear in the control until any currency value is entered by the user. If the user entered currency value is removed in the control, the value specified in this field reappears.

    Hint

    Hint text that will display to users when a user clicks into the control.

    Help

    Help text that will appear for the control. If you specify help text, a help icon appears next to the name of the control and displays the help text when a user hovers over it or clicks it.

    Min

    Specify the minimum amount that users need to enter into the control.

    Max

    Specify the maximum amount that users can enter into the control.

    Show up/down buttons

    Select this property to display the up and down arrow buttons used to increment or decrement the control value.

    Step
    Specify a step value based on which the amount will be incremented or decremented correspondingly when a user increments or decrements the amount in the control. By default, the step value in this field is set to 1. For example, if the step value specified is 3 and the initial amount is $ 0.00, then, when a user increments the amount in the control for the first time, the amount is updated to $ 3.00. When the user increments the amount again for the second time, the amount is updated to $ 6.00 and so on.

    Note:

    This property is displayed only when you select the Show increment/decrement buttons check box.

    Required

    Select this property to specify that users must provide a value in order to successfully submit the form. An asterisk displays to indicate that it's a required field.

    Autocomplete

    Select this property to display autocompletion entries when users begin to enter text into the control.

    Disabled

    Select this property to display the control as inactive (grayed out) to users.

    Auto Focus

    Select this property to automatically focus on this control when the form loads. If multiple controls are set to Auto Focus, the focus goes to the first control in the form.

    Read Only

    Select this property to display the control's content (if any) without allowing users to edit it.

    Hide

    Select this property to hide the control.
  3. Use the Styling tab in the Properties pane to modify the control’s appearance as needed. See Styling Properties.