WindowObject Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Fenster dar, das in der Microsoft InfoPath-Anwendung verwendet wird.
public interface class WindowObject : Microsoft::Office::Interop::InfoPath::SemiTrust::Window2
[System.Runtime.InteropServices.Guid("096cd5f7-0786-11d1-95fa-0080c78ee3bb")]
public interface WindowObject : Microsoft.Office.Interop.InfoPath.SemiTrust.Window2
type WindowObject = interface
interface Window2
interface Window
Public Interface WindowObject
Implements Window2
- Attribute
- Implementiert
Beispiele
Im folgenden Beispiel, das als OnClick-Ereignishandler für ein Schaltflächensteuerelement implementiert wird, 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 den Typ des Bearbeitungsfensters handelt, wird die Anzahl der Aufgabenbereiche angezeigt, die im Fenster in einem Meldungsfeld enthalten sind.
[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.
Hinweise
Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, finden Sie unterWindow2 .
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.
Auf die WindowObject-Objekte eines InfoPath-Formulars wird über die Item[Object] -Eigenschaft zugegriffen. Der Typ des Fensters kann mithilfe der WindowType -Eigenschaft bestimmt werden.
Sie können direkt auf das aktuell geöffnete Fenster zugreifen, indem Sie die ActiveWindow -Eigenschaft des Application -Objekts verwenden, ohne die WindowsCollection Auflistung zu durchlaufen. Sie können auch mithilfe der -Eigenschaft auf das WindowObject-Objekt zugreifen, das Window einer Ansicht zugeordnet ist.
Hinweis: Einige Eigenschaften des WindowObject-Objekts sind nur verfügbar, wenn der Bearbeitungsfenstertyp verwendet wird. Sie geben einen Fehler zurück, wenn sie mit dem Entwurfsfenstertyp verwendet werden.
Eigenschaften
Active |
Ruft einen Wert ab, der angibt, ob das dem WindowObject -Objekt zugeordnete Fenster das aktive Fenster ist. (Geerbt von Window2) |
Caption |
Ruft den Untertitel Text für das durch das -Objekt dargestellte Fenster ab oder legt diese WindowObject fest. (Geerbt von Window2) |
CommandBars |
Ruft einen Verweis auf die Microsoft Office CommandBars-Auflistung ab, die in dem Fenster enthalten ist, das dem WindowObject -Objekt zugeordnet ist. (Geerbt von Window2) |
Height |
Ruft die Höhe des durch das WindowObject -Objekt dargestellten Fensters in Punkt ab oder legt diese fest. (Geerbt von Window2) |
Left |
Ruft die horizontale Position des durch das WindowObject -Objekt dargestellten Fensters in Punkt ab oder legt diese fest. (Geerbt von Window2) |
MailEnvelope |
Ruft einen Verweis auf das MailEnvelopeObject -Objekt ab, das dem Fenster zugeordnet ist, das durch das WindowObject -Objekt dargestellt wird. (Geerbt von Window2) |
TaskPanes |
Ruft einen Verweis auf die TaskPanesCollection Auflistung ab, die dem WindowObject -Objekt zugeordnet ist. (Geerbt von Window2) |
Top |
Ruft die vertikale Position des durch das WindowObject -Objekt dargestellten Fensters in Punkt ab oder legt diese fest. (Geerbt von Window2) |
Width |
Ruft die Breite des durch das WindowObject -Objekt dargestellten Fensters in Punkt ab oder legt diese fest. (Geerbt von Window2) |
WindowState |
Ruft den Zustand des Fensters ab, das durch das -Objekt dargestellt wird, oder legt den WindowObject Zustand fest. (Geerbt von Window2) |
WindowType |
Ruft einen XdWindowType Wert ab, der den Typ des Fensters angibt, das durch das WindowObject -Objekt dargestellt wird. (Geerbt von Window2) |
XDocument |
Ruft einen Verweis auf das XDocument -Objekt ab, das dem Fenster zugeordnet ist, das durch das WindowObject -Objekt dargestellt wird. (Geerbt von Window2) |
Methoden
Activate() |
Aktiviert das Fenster, das durch das WindowObject -Objekt dargestellt wird. (Geerbt von Window2) |
Close(Boolean) |
Schließt das Fenster, das durch das WindowObject -Objekt dargestellt wird. (Geerbt von Window2) |