Reflects the current release of Nintex for SharePoint 2016. For your version, please access assistance through the Help button in the product.

Calculated Value control

The Calculated Value control performs a calculation or concatenation (depending on the data type of the values used within the Formula Builder) and displays the result at run time.

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: For information about the control properties tab in the Nintex Forms ribbon, see Control properties tab.

Section Field Description Nintex Mobile

General

Formula

The runtime formula to be calculated. Use the Formula Builder to create the formula.

Yes

 

Name

The name of the control. The name is used for comparison validation and other control references.

Yes

 

Title

(Responsive Forms Designer only)

Title of the control. The title is displayed as the label for the control.

Yes

 

Description

(Responsive Forms Designer only)

Description of the control. The description displays additional information or instructions for the control.

Yes

 

Connected to

The field to bind the input control to. For more information, see Connect controls to fields.

Yes

 

Save as data type

The data type to convert to when the form is saved.

If Decimal is selected:

  • Decimal places: The number of decimal places.
  • Show as percentage: Format the value as a percentage.

If Decimal or Integer is selected:

  • Use thousand separator: Whether 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. By default, this is set to yes.

No

 

Recalculate formula on edit mode

Recalculate the value when the form is displayed in edit mode at run time. By default, this is set to yes.

No

Appearance

Visible

Hide or show the control at runtime.

Yes

 

Enabled

​Enable the control to receive user input at run time.

Yes

Formatting


(Classic Forms Designer only)

Control CSS class

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

No

 

CSS class

The CSS class to apply to the control. This is used to apply advanced styling options. The Custom CSS class is defined in Form Settings (refer to Form and Layout settings).

No

 

Border

​Draws a line along the select border of the control.

No

 

Border Style

The style of the border.

No

 

Border Width (Pixels)

​The width of the border in pixels.

No

 

Border Color

The color of the border. This can either be a HEX code or a named color that is supported by html.

No

 

Padding Width (Pixels)

The amount of padding in pixels that will appear between the top, left and right border and the inner control.

No

Advanced

Help text

Text that will be displayed to the user as a tooltip to guide the completion of the form.

No
 

Control Mode

​Force control to be in Edit mode, Display mode, or set to Auto.

No
 

Convert empty string to null

​Convert to a null value if the control contains an empty string. No
 

Null display text

​If the bound value is null, this value will be displayed instead. No
 

Store Client ID in JavaScript variable

A JavaScript Variable will be created that references the Client ID of this control.

If Yes is selected:

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

Note:  Custom JavaScript is available in the Classic Forms Designer only.

No
 

Resize at runtime

Allow the control to dynamically adjust its size, and adjust the form length and position of other controls accordingly. No

Related Topics

Forms designer
Control Settings
Controls In Use
Shortcut keys
Inserting reference fields
Formula Builder
Control Properties Ribbon