Multi Line Textbox control

You are here:

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

The Multi Line Textbox control allows users to enter plain text on the form. You can also use this control to collect metadata. For more information, see Collect metadata from the app (optional).

As with other controls, the Multi Line Textbox control inherits properties and settings from the field it is connected to. One property not visible in the Control Settings dialog box is the ability in SharePoint to show the history of the field. When enabled in the column settings, this will render at runtime as per the existing SharePoint functionality. We however will take up some of the space allocated to the control to display this history. The control will not grow as more history is collected.

Control settings

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

Note: Several settings allow selection of Yes, No, or Expression. Selecting Expression allows you to construct a formula from reference tokens and functions. 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.

Note: For information about the control properties tab in the Nintex Forms ribbon, see Control properties tab.

Section	Field	Description	Nintex Mobile
General	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
	Default value	Set a default value for the control. This value will only be used if a default value has not been specified in the column or variable selected in the Connected to setting.	Yes
	Rich text	Allow rich text format to be entered. If Yes is selected: Specify the type of text to allow: Select rich text, or Enhanced rich text.	Yes
Appearance	Visible	Hide or show the control at runtime.	Yes
	Enabled	Enable the control to receive user input when the form is in input mode.	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
Validation	Required	The form will not submit unless this control is completed correctly. If Yes is selected: Required error message: The error message to display when the required field is not specified.	Yes
	Use custom validation	Enables the value entered into the control to be validated by a JavaScript function. If Yes is selected: Custom validation function: Specify the JavaScript function name for the client side custom validation. Note: The JavaScript function is to be specified in the Custom JavaScript section within the form's Settings. Custom error message: The error message to display when an invalid value is entered. Note: Custom JavaScript is available in the Classic Forms Designer only.	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 text 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

Section

Field

Description

Nintex Mobile

General

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

Default value

Set a default value for the control. This value will only be used if a default value has not been specified in the column or variable selected in the Connected to setting.

Yes

Rich text

Allow rich text format to be entered.

If Yes is selected:

Specify the type of text to allow: Select rich text, or Enhanced rich text.

Yes

Appearance

Visible

Hide or show the control at runtime.

Yes

Enabled

Enable the control to receive user input when the form is in input mode.

Yes

Formatting

(Classic Forms Designer only)

Control CSS class

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

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

Border

Draws a line along the select border of the control.

Border Style

The style of the border.

Border Width (Pixels)

The width of the border in pixels.

Border Color

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

Padding Width (Pixels)

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

Validation

Required

The form will not submit unless this control is completed correctly.

If Yes is selected:

Required error message: The error message to display when the required field is not specified.

Yes

Use custom validation

Enables the value entered into the control to be validated by a JavaScript function.

If Yes is selected:

Custom validation function: Specify the JavaScript function name for the client side custom validation. Note: The JavaScript function is to be specified in the Custom JavaScript section within the form's Settings.
Custom error message: The error message to display when an invalid value is entered.

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

Advanced

Help text

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

Control Mode

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

Convert empty string to null

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

Null display text

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

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.

Resize at runtime

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

Multi Line Textbox control

Control settings

Related Topics