En este ejemplo se muestra cómo utilizar las propiedades de instance manager (que forma parte del Modelo de objetos de formulario XML) para recuperar información sobre subformularios en tiempo de ejecución.
En el siguiente formulario, los cuatro botones proporcionan información sobre Subform1 mediante las propiedades de secuencia de comandos de instance manager. Por ejemplo, cuando la persona que rellena el formulario hace clic en el botón Máx., aparece un mensaje que describe el número máximo permitido de instancias de Subform1 admitidas.
Secuencia de comandos para el cuadro de mensaje que muestra el resultado del valor de la propiedad count
La siguiente secuencia de comandos utiliza el método messageBox para obtener el valor de la propiedad count:
xfa.host.messageBox("The current number of Subform1 instances on the
form is:" + properties.Subform1.instanceManager.count, "Instance Manager
Properties",3);
También puede escribir esta secuencia de comandos con notación de subrayado (_) para hacer referencia a la propiedad count de instance manager, tal como se indica a continuación:
xfa.host.messageBox("The current number of Subform1 instances on the form
is: " + properties._Subform1.count, "Instance Manager Properties", 3);
La notación de subrayado (_) es especialmente importante si no existe ninguna instancia de subformulario en el formulario.
Secuencia de comandos para el cuadro de mensaje que muestra el resultado del valor de la propiedad max
La siguiente secuencia de comandos utiliza el método messageBox para obtener el valor de la propiedad max:
xfa.host.messageBox("The maximum number of instances allowed for Subform1
is: " + properties.Subform1.instanceManager.max, "Instance Manager
Properties", 3);
También puede escribir esta secuencia de comandos con notación de subrayado (_) para hacer referencia a la propiedad max de instance manager, tal como se indica a continuación:
xfa.host.messageBox("The maximum number of instances allowed for Subform1
is: " + properties._Subform1.max, "Instance Manager Properties", 3);
Secuencia de comandos para el cuadro de mensaje que muestra el resultado del valor de la propiedad min
La siguiente secuencia de comandos utiliza el método messageBox para obtener el valor de la propiedad min:
xfa.host.messageBox("The minimum number of instances allowed for Subform1
is: " + properties.Subform1.instanceManager.min, "Instance Manager
Properties", 3);
También puede escribir esta secuencia de comandos con notación de subrayado (_) para hacer referencia a la propiedad min de instance manager, tal como se indica a continuación:
xfa.host.messageBox("The minimum number of instances allowed for Subform1
is: " + properties._Subform1.min, "Instance Manager Properties", 3);
Secuencia de comandos para el cuadro de mensaje que muestra el resultado del valor de la propiedad subform
La siguiente secuencia de comandos utiliza el método messageBox para obtener el nombre de la propiedad 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);
También puede escribir esta secuencia de comandos con notación de subrayado (_) para hacer referencia a la propiedad de instance manager, tal como se indica a continuación:
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);