addInstance

Adds a new instance of a subform or subform set to the form model.

Syntax

Reference_Syntax.addInstance( BOOLEAN param )

Parameters

param (Optional)

Indicates if the new subform or subform set has a corresponding data value in the data model.

  • true | 1 (JavaScript) or 1 (FormCalc)(default)

  • Merge the new subform or subform set with the data model.

  • false | 0 (JavaScript) or 0 (FormCalc)

  • Do not perform a merge operation.

Returns

The new form object, or null if no object was added.

Applies to

Model

Object

Form Model

instanceManager

Version

XFA 2.1

Examples

JavaScript

Subform1.instanceManager.addInstance(1);

FormCalc

Subform1.instanceManager.addInstance(1)

// Ethnio survey code removed