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.
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.
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.