WindowObject-Schnittstelle

Artikel
04/27/2010

Stellt ein Fenster dar, das in der Microsoft Office InfoPath 2007-Anwendung verwendet wird.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(WindowObjectWrapper))> _
<GuidAttribute("096cd5f7-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface WindowObject
    Inherits Window2, Window

Dim instance As WindowObject

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

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter Window2.

Die WindowObject-Objekte stellen die zwei Fenstertypen dar, die in der InfoPath-Anwendung verwendet werden: das Bearbeitungsfenster, das als Formularbereich verwendet wird, wenn ein Benutzer ein Formular ausfüllt, und das Entwurfsfenster, das im Entwurfsmodus verwendet wird, wenn ein Benutzer ein Formular entwirft.

Das WindowObject-Objekt stellt mehrere Eigenschaften und Methoden bereit, die für die programmgesteuerte Interaktion mit InfoPath-Fenstern verwendet werden können, einschließlich der Möglichkeit, ein Fenster zu aktivieren oder zu schließen, und der Möglichkeit, mit den im Fenster enthaltenen Aufgabenbereichen und Befehlsleisten zu arbeiten. Darüber hinaus stellt das WindowObject-Objekt eine Eigenschaft für den Zugriff auf das dem Formular zugrunde liegende XML-Dokument bereit, das dem Fenster zugeordnet ist.

Der Zugriff auf die WindowObject-Objekte eines InfoPath-Formulars erfolgt über die Item-Eigenschaft. Der Fenstertyp kann mithilfe der WindowType-Eigenschaft bestimmt werden.

Mithilfe der ActiveWindow-Eigenschaft des Application-Objekts können Sie direkt auf das derzeit geöffnete Fenster zugreifen, ohne den Weg über die WindowsCollection-Auflistung gehen zu müssen. Sie können auch auf das einer Ansicht zugeordnete WindowObject-Objekt zugreifen, indem Sie die Window-Eigenschaft verwenden.

Hinweis:
Einige Eigenschaften des WindowObject-Objekts sind nur verfügbar, wenn ein Bearbeitungsfenster verwendet wird. Wenn diese Eigenschaften für Entwurfsfenster verwendet werden, wird ein Fehler zurückgegeben.

Beispiel

Im folgenden Beispiel, das als OnClick-Ereignishandler für das Steuerelement "Schaltflächen" implementiert wurde, wird die ActiveWindow-Eigenschaft verwendet, um einen Verweis auf das aktuelle Fenster festzulegen. Anschließend überprüft der Code den Fenstertyp. Wenn es sich um ein Bearbeitungsfenster handelt, wird die Anzahl der im Fenster enthaltenen Aufgabenbereiche in einem Meldungsfeld angezeigt.

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

Codebeispiele finden Sie unter Vorgehensweise: Arbeiten mit Formularfenstern mithilfe des InfoPath 2003-Objektmodells.

Siehe auch

Referenz

WindowObject-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über