Interfaz WindowObject

Artículo
05/12/2015

Representa una ventana que se utiliza en una aplicación de Microsoft InfoPath.

Espacio de nombres: Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado: Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
<GuidAttribute("096cd5f7-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface WindowObject _
    Inherits Window2, Window
'Uso
Dim instance As WindowObject

[GuidAttribute("096cd5f7-0786-11d1-95fa-0080c78ee3bb")]
public interface WindowObject : Window2, 
    Window

Comentarios

Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Encontrará información sobre la interfaz COM, así como vínculos a las descripciones de sus miembros, enWindow2.

Los objetos WindowObject representan los dos tipos de ventanas que se utilizan en la aplicación InfoPath: la ventana de edición, que se utiliza como área del formulario cuando un usuario rellena un formulario, y la ventana de diseño, que se utiliza como modo de diseño cuando un usuario diseña un formulario.

El objeto WindowObject proporciona varias propiedades y varios métodos que se pueden utilizar para interactuar mediante programación con las ventanas de InfoPath, incluida la capacidad para activar o cerrar una ventana y para interactuar con los paneles de tareas y las barras de comandos que contienen. El objeto WindowObject también proporciona una propiedad para tener acceso al documento XML subyacente del formulario que está asociado a la ventana.

A los objetos WindowObject de un formulario de InfoPath se tiene acceso a través de la propiedad Item. Se puede determinar el tipo de ventana mediante la propiedad WindowType.

Puede tener acceso directo a la ventana abierta en ese momento mediante la propiedad ActiveWindow del objeto Application, sin tener que utilizar la colección WindowsCollection. También puede tener acceso al objeto WindowObject asociado a una vista utilizando la propiedad Window.

Nota

Algunas propiedades del objeto WindowObject únicamente están disponibles cuando se utiliza el tipo de ventana de edición y devolverán un error si se utilizan con ventanas de diseño.

Ejemplos

En el ejemplo siguiente, implementado como controlador de eventos OnClick para un control de botón, se utiliza la propiedad ActiveWindow para establecer una referencia a la ventana activa. A continuación, el código comprueba el tipo de ventana y, si es de edición, muestra el número de paneles de tareas que contiene en un cuadro de mensaje.

[InfoPathEventHandler(MatchPath=" WindowObject", EventType=InfoPathEventType.OnClick)]
public void WindowObject_OnClick(DocActionEvent e)
{
 Window2 activeWindow;
   
 // Set a reference to the current window.
 activeWindow = thisApplication.ActiveWindow;
 
 // Check that the window is an editing window type.
 if (activeWindow.WindowType == XdWindowType.xdEditorWindow)
 {
  // Display the number of task panes in the window.
  thisXDocument.UI.Alert("Number of task panes: " + 
   activeWindow.TaskPanes.Count);
 }
}

Para obtener ejemplos de código, vea Cómo: Trabajar con ventanas de formularios usando el modelo de objetos de InfoPath 2003

Vea también

Referencia

Miembros WindowObject

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust

Share via