Window-Klasse

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

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

Public MustInherit Class Window

Dim instance As Window
public abstract class Window

Hinweise

Die Window-Objekte stellen die beiden Fenstertypen dar, die in der InfoPath-Anwendung verwendet werden: das Bearbeitungsfenster, das ein Formular anzeigt, wenn ein Benutzer ein Formular ausfüllt, und das Entwurfsfenster, das im Entwurfsmodus verwendet wird, wenn ein Benutzer eine Formularvorlage entwirft.

Das Window-Objekt stellt 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 Window-Objekt die XmlForm-Eigenschaft für den Zugriff auf das dem Formular zugrunde liegende XML-Dokument bereit, das dem Fenster zugeordnet ist.

Der Zugriff auf die Window-Objekte eines InfoPath-Formulars erfolgt über die Item-Eigenschaft des WindowCollection-Objekts. 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 die WindowCollection-Auflistung verwenden zu müssen. Sie können auch auf das einer Ansicht zugeordnete Window-Objekt zugreifen, indem Sie die Window-Eigenschaft des View-Objekts verwenden.

Hinweis:

Einige Eigenschaften des Window-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 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.

// Set a reference to the current window.
Window currentWindow = this.Application.ActiveWindow;

// Check if the window is an editing window;
if (currentWindow.WindowType == WindowType.Editor)
{
   MessageBox.Show("Number of task panes: " + 
      currentWindow.TaskPanes.Count.ToString());
}
' Set a reference to the current window.
Dim currentWindow As Window  = Me.Application.ActiveWindow

' Check if the window is an editing window;
If currentWindow.WindowType = WindowType.Editor Then
   MessageBox.Show("Number of task panes: " & _
      currentWindow.TaskPanes.Count.ToString())
End If

Vererbungshierarchie

System.Object
  Microsoft.Office.InfoPath.Window

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Window-Member
Microsoft.Office.InfoPath-Namespace