Como usar as propriedades do Gerenciador de instâncias para controlar os subformulários

Este exemplo demonstra como usar as propriedades do Gerenciador de instâncias (que faz parte do Modelo de objeto de formulário XML) para recuperar informações sobre subformulários em tempo de execução.

No formulário a seguir, os quatro botões fornecem informações sobre o Subform1 usando as propriedades de script do Gerenciador de instâncias. Por exemplo, quando o usuário clica no botão Máx, aparece uma mensagem descrevendo o número máximo permitido de instâncias suportadas do Subform1.

Script da caixa de mensagem para exibir o valor da propriedade count

O script a seguir usa o método messageBox para exibir o valor da propriedade count:

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

Você também pode gravar esse script usando o underscore (_) para fazer referência à propriedade count do Gerenciador de instâncias, da seguinte maneira:

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

O underscore (_) será importante principalmente se não houver nenhuma instância de subformulário no formulário.

Script da caixa de mensagem para exibir o valor da propriedade max

O script a seguir usa o método messageBox para exibir o valor da propriedade max:

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

Você também pode gravar esse script usando o underscore (_) para fazer referência à propriedade max do Gerenciador de instâncias, da seguinte maneira:

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

Script da caixa de mensagem para exibir o valor da propriedade min

O script a seguir usa o método messageBox para exibir o valor da propriedade min:

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

Você também pode gravar esse script usando o underscore (_) para fazer referência à propriedade min do Gerenciador de instâncias, da seguinte maneira:

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

Script da caixa de mensagem para exibir o nome da propriedade subform

O script a seguir usa o método messageBox para exibir o nome da propriedade 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);

Você também pode gravar esse script usando o underscore (_) para fazer referência à propriedade name do Gerenciador de instâncias, da seguinte maneira:

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