Interfaccia WindowObject

Articolo
04/27/2010

Rappresenta una finestra utilizzata nell'applicazione Microsoft Office InfoPath 2003.

Spazio dei nomi: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Sintassi

<GuidAttribute("096CD5F7-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(WindowObjectClass))> _
Public Interface WindowObject
    Inherits Window2

Dim instance As WindowObject

[GuidAttribute("096CD5F7-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(WindowObjectClass))] 
public interface WindowObject : Window2

Osservazioni

Questo tipo è un wrapper per una coclasse richiesta dal codice gestito per l'interoperabilità COM. Utilizzare questo tipo per accedere ai membri dell'interfaccia COM implementata dalla coclasse. Per informazioni sull'interfaccia COM e un collegamento alle descrizioni dei relativi membri, vedere Window2.

L'oggetto WindowObject rappresenta i due tipi di finestra che vengono utilizzati nell'applicazione InfoPath: la finestra di modifica, che funge da area in cui l'utente compila un modulo, e la finestra di progettazione, in cui è possibile progettare un modulo.

L'oggetto WindowObject implementa numerosi metodi e proprietà che consentono di interagire a livello di programmazione con le finestre di InfoPath, ad esempio per attivare o chiudere una finestra e interagire con i riquadri attività e le barre dei comandi inclusi nelle finestre. L'oggetto WindowObject implementa inoltre una proprietà per l'accesso al documento XML sottostante del modulo associato alla finestra.

È possibile accedere agli oggetti WindowObject di un modulo di InfoPath tramite la proprietà Item. È possibile determinare il tipo di finestra utilizzando la proprietà WindowType.

È possibile accedere alla finestra aperta direttamente utilizzando la proprietà ActiveWindow dell'oggetto Application, senza ricorrere all'insieme WindowsCollection. È inoltre possibile accedere all'oggetto WindowObject associato a una visualizzazione utilizzando la proprietà Window.

Nota:
Alcune proprietà dell'oggetto WindowObject sono disponibili solo quando si utilizza la finestra di modifica e restituiscono un errore se utilizzate con la finestra di progettazione.

Esempio

Nell'esempio seguente, implementato come gestore eventi OnClick per un controllo pulsante, la proprietà ActiveWindow viene utilizzata per impostare un riferimento alla finestra corrente. Viene quindi controllato il tipo di finestra e, se si tratta di una finestra di modifica, viene visualizzato il numero di riquadri attività in essa inclusi in una finestra di messaggio.

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

Per gli esempi di codice, vedere Procedura: Utilizzare le finestre di un modulo tramite il modello a oggetti di InfoPath 2003.

Vedere anche

Riferimenti

Membri WindowObject
Spazio dei nomi Microsoft.Office.Interop.InfoPath

Condividi tramite