insertInstance

Inserts a new instance of a subform or subform set into a form.

Syntax

Reference_Syntax.insertInstance( INTEGER param1 [, BOOLEAN param2 ] )

Parameters

param1

An integer specifying the zero-indexed position to insert the instance within a set of instances.

param2

(optional)

A Boolean value indicating if data must be merged with the new subform instance.

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

  • Merges the new subform instance with the available data.

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

  • The new subform instance is not merged with data.

Returns

An object representing the new instance of the subform or subform set.

Applies to

Model

Object

sourceSet Model

source

Version

XFA 2.1

Examples

JavaScript

Subform1.instanceManager.insertInstance(3, 0);

FormCalc

Subform1.instanceManager.insertInstance(3, 0)

// Ethnio survey code removed