Teilformulare mit Hilfe der Eigenschaften des Instanzmanagers steuern

Dieses Beispiel zeigt, wie Sie mit den Eigenschaften des Instanzmanagers (der zum XML Form Object Model gehört) zur Laufzeit Informationen über Teilformulare abrufen.

Im folgenden Formular nutzen die vier Schaltflächen die Skripteigenschaften des Instanzmanagers und liefern Informationen über Subform1. Wenn ein Formularbenutzer beispielsweise auf die Schaltfläche "Max" klickt, wird eine Meldung eingeblendet, welche die maximal zulässige Anzahl unterstützter Subform1-Instanzen angibt.

Grafik in Originalgröße anzeigen

Skripten zur Ausgabe des Wertes der Eigenschaft "count" im Meldungsfeld

Dieses Skript verwendet die Methode messageBox, um den Wert der Eigenschaft count auszugeben:

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

Sie können dieses Skript auch mit der Unterstrich-Notation (_) schreiben, um die Eigenschaft count des Instanzmanagers zu referenzieren, wie in diesem Beispiel:

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

Die Unterstrich-Notation (_) ist besonders wichtig, wenn das Formular zurzeit keine Teilformularinstanzen enthält.

Skripten zur Ausgabe des Wertes der Eigenschaft "max" im Meldungsfeld

Dieses Skript verwendet die Methode messageBox, um den Wert der Eigenschaft max auszugeben:

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

Sie können dieses Skript auch mit der Unterstrich-Notation (_) schreiben, um die Eigenschaft max des Instanzmanagers zu referenzieren, wie in diesem Beispiel:

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

Skripten zur Ausgabe des Wertes der Eigenschaft "min" im Meldungsfeld

Dieses Skript verwendet die Methode messageBox, um den Wert der Eigenschaft min auszugeben:

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

Sie können dieses Skript auch mit der Unterstrich-Notation (_) schreiben, um die Eigenschaft min des Instanzmanagers zu referenzieren, wie in diesem Beispiel:

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

Skripten zur Ausgabe des Namens der Teilformulareigenschaft im Meldungsfeld

Dieses Skript verwendet die Methode messageBox, um den Namen der Eigenschaft subform auszugeben:

    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);

Sie können dieses Skript auch mit der Unterstrich-Notation (_) schreiben, um die Eigenschaft "name" des Instanzmanagers zu referenzieren, wie in diesem Beispiel:

    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);