Livecycle

Utilisation des propriétés du gestionnaire d’instances pour contrôler les sous-formulaires

Cet exemple vous montre comment utiliser les propriétés du gestionnaire d’instances (qui fait partie du modèle d’objet de formulaire XML) pour récupérer les informations sur les sous-formulaires au moment de l’exécution.

Dans le formulaire suivant, les quatre boutons donnent des informations sur le Sous-formulaire 1 grâce aux propriétés de script du gestionnaire d’instances. Par exemple, lorsque l’utilisateur clique sur le bouton Max., un message décrivant le nombre maximal d’instances du Sous-formulaire 1 prises en charge s’affiche.

Script pour la zone de message pour la génération de la valeur de la propriété Count

Le script suivant utilise la méthode messageBox pour générer la valeur de la propriété count :

xfa.host.messageBox(“The current number of Subform1 instances on the
form is:” + properties.Subform1.instanceManager.count, “Instance Manager
Properties”,3);

Vous pouvez également écrire ce script en utilisant du trait de soulignement (_) pour référencer la propriété count du gestionnaire d’instances, comme indiqué ci-après :

xfa.host.messageBox(“The current number of Subform1 instances on the form
is: ” + properties._Subform1.count, “Instance Manager Properties”, 3);

Le trait de soulignement (_) est particulièrement important s’il n’existe aucune instance de sous-formulaire sur le formulaire.

Script pour la zone de message pour la génération de la valeur de la propriété Max

Le script suivant utilise la méthode messageBox pour générer la valeur de la propriété max :

xfa.host.messageBox(“The maximum number of instances allowed for Subform1
is: ” + properties.Subform1.instanceManager.max, “Instance Manager
Properties”, 3);

Vous pouvez également écrire ce script en utilisant du trait de soulignement (_) pour référencer la propriété max du gestionnaire d’instances, comme indiqué ci-après :

xfa.host.messageBox(“The maximum number of instances allowed for Subform1
is: ” + properties._Subform1.max, “Instance Manager Properties”, 3);

Script pour la zone de message pour la génération de la valeur de la propriété Min

Le script suivant utilise la méthode messageBox pour générer la valeur de la propriété min :

xfa.host.messageBox(“The minimum number of instances allowed for Subform1
is: ” + properties.Subform1.instanceManager.min, “Instance Manager
Properties”, 3);

Vous pouvez également écrire ce script en utilisant du trait de soulignement (_) pour référencer la propriété min du gestionnaire d’instances, comme indiqué ci-après :

xfa.host.messageBox(“The minimum number of instances allowed for Subform1
is: ” + properties._Subform1.min, “Instance Manager Properties”, 3);

Script pour la zone de message pour la génération de la valeur de la propriété Subform

Le script suivant utilise la méthode messageBox pour générer la valeur de la propriété subform :

xfa.host.messageBox(“The name of the subform using the instance manager name
property is: ” + properties.Subform1.instanceManager.name +

“.\n\nNote: This value is different than the value returned by the name
property for the Subform1 object.” , “Instance Manager Properties”, 3);

Vous pouvez également écrire ce script en utilisant du trait de soulignement (_) pour référencer le nom de la propriété du gestionnaire d’instances, comme indiqué ci-après :

xfa.host.messageBox(“The name of the subform using the instance manager name
property is: ” + properties._Subform1.name +
“.\n\nNote: This value is different than the value returned by the name
property for the Subform1 object.” , “Instance Manager Properties”, 3);

Utilisation des propriétés du gestionnaire d’instances pour contrôler les sous-formulaires