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 Subform1 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 de Subform1 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 le 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 le 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 le 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 le nom 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);