Window-Klasse

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

Vererbungshierarchie

System.Object
  Microsoft.Office.InfoPath.Window

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustInherit Class Window
'Usage
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.

Beispiele

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

Window-Member

Microsoft.Office.InfoPath-Namespace