Calculated Value control

Performs a calculation or concatenation (depending on the data type of the values used within the formula) and displays the result at run time.

Note: This control is supported in Nintex Mobile, except for noted fields.

Control settings

Following are the fields and options visible in the control settings dialog box for this form control.

Note: CSS formatting controls are available in the classic forms designer only. To style responsive forms, configure theme settings in the Properties pane.

Section Field Description Nintex Mobile

General

Formula

The runtime formula to be calculated. Depending on the composition of the formula, the value displayed in the control calculates to reflect the current values entered in named controls that are included in the formula.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

Yes
 

Name

 Assign a name to the control. The name is used for comparison validation and other control references. 

Yes

 

Title (R)

Text to display above the field on the published form. Acts as a label for the control.

Yes

 

Description (R)

Helper text to display under the field on the published form.

Yes
 

Connected to

The field to bind the input control to.

Yes
 

Save as data type

The data type to convert to when the form is saved. Select one of the following options.

  • General: Renders string values as trimmed. For example, renders the value "0000156" as "156".
  • String: Renders string values untrimmed. For example, renders the value "0000156" as "0000156".
  • Integer: Renders integer values.
    • Use thousand separator: Specify whether or not to use a thousand separator.
  • Decimal: Renders decimal values.

    • Decimal places: The number of decimal places.

      You can insert references into select fields for control, form, and layout settings.

      To insert a reference:

      1. Click the field.

        The Insert Reference pane appears on the right.

      2. Select the reference.

      For more information, see Insert References.

    • Use thousand separator: Specify whether or not to use a thousand separator.

    • Show as percentage: Specify whether or not to format the value as a percentage. Select one of the following options.

      • Yes
      • No

      • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

      You can insert references into select fields for control, form, and layout settings.

      To insert a reference:

      1. Click the field.

        The Insert Reference pane appears on the right.

      2. Select the reference.

      For more information, see Insert References.

  • Currency: Renders currency values.
    • Use thousand separator: Specify whether or not to use a thousand separator.

Yes
 

Value prefix

The prefix for the value.  

Yes
 

Value suffix

The suffix for the value.

Yes
 

Recalculate formula on view mode

Recalculate the value when the form is displayed in view mode at run time. 

No
 

Recalculate formula on new mode

Recalculate the value when the form is displayed in new mode at run time. 

No
 

Recalculate formula on edit mode

Recalculate the value when the form is displayed in edit mode at run time. 

No

Appearance

Visible

Hide or show the control at runtime. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

Yes

 

Enabled

Enable the control to receive user input at run time. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

Yes

Formatting (C)

Control CSS class

The CSS class to apply to the inner elements of the control.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

CSS class

The CSS class to apply to the control.

Use this setting to apply advanced styling options using custom CSS classes defined in the form settings.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

Border

Specify borders to display. Select zero or more of the following options.

  • Top
  • Bottom
  • Left
  • Right

No
 

Border Style

Specify the style of the border line. Select one of the following options.

  • Default
  • None
  • Dotted
  • Dashed
  • Solid
  • Double
  • Groove
  • Ridge
  • Inset
  • Outset

No
 

Border Width (Pixels)

The width of the line in pixels.

To hide the border, enter zero ("0").

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

Border Color

The color of the line.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

Padding Width (Pixels)

The width of the padding between the edge of the control and the content of the control.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No

Advanced

Help text

Text to display as a tooltip to guide the completion of the form.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

Control Mode

Select one of the following options.

  • Auto
  • Edit: Force control be in edit mode.
  • Display: Force control to be in display mode.

No
 

Convert empty string to null

Convert to a null value if the control contains an empty string. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

Null display text

Value to display if the bound value is null.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No
 

Store Client ID in JavaScript variable (C)

Specify whether or not to store the client ID in a JavaScript variable. Select one of the following options.

  • Yes: A JavaScript variable is created to reference the client ID of this control.

    • Client ID JavaScript variable name: The name of the variable to store the client ID in.

    You can insert references into select fields for control, form, and layout settings.

    To insert a reference:

    1. Click the field.

      The Insert Reference pane appears on the right.

    2. Select the reference.

    For more information, see Insert References.

  • No

Custom JavaScript is available in the classic forms designer only.

No
 

Resize at runtime (C)

Dynamically adjust size and adjust the form length and position of other controls accordingly. Select one of the following options.

  • Yes
  • No

  • Expression: Evaluate an expression (formula) constructed from reference tokens and functions for a Yes/No value. The expression must resolve to a Yes/No value at runtime to be valid. If the expression does not resolve to a Yes/No value it will revert to the default.

You can insert references into select fields for control, form, and layout settings.

To insert a reference:

  1. Click the field.

    The Insert Reference pane appears on the right.

  2. Select the reference.

For more information, see Insert References.

No

(R): Available with the responsive designer only.

(C): Available with the classic designer only.