removeInstance

Supprime un sous-formulaire ou un jeu de sous-formulaires spécifique du modèle de formulaire.

Lors de la suppression d’une instance de sous-formulaire, évitez les violations d’occurrences de sous-formulaire. En effet, vous ne pouvez pas supprimer d’instance de sous-formulaire lorsque le nombre minimum d’instances a été atteint. Lorsque cette valeur minimale est atteinte pour un sous-formulaire, le débogueur JavaScript affiche un message d’erreur :

The element [min] has violated its allowable number of occurrences.

Si l’utilisateur final est autorisé à supprimer toutes les instances d’un sous-formulaire, réinitialisez le nombre minimum d’instances sur la valeur 0 avant de tenter de supprimer une instance. A défaut, le script empêchera toute tentative de suppression d’instances de sous-formulaire en deçà du nombre minimum.

Syntaxe

Reference_Syntax.removeInstance( INTEGER param )

Paramètres

param

Entier valide représentant la position de l’index de base de 0 au sein d’un modèle de formulaire pour le sous-formulaire ou jeu de sous-formulaires à supprimer.

Renvoie

Vide

Application

Version

XFA 2.1

Exemples

JavaScript

Subform2.instanceManager.removeInstance(3);

FormCalc

Subform2.instanceManager.removeInstance(3)