WindowsCollection-Schnittstelle

Enthält ein WindowObject-Objekt für jedes derzeit geöffnete Microsoft Office InfoPath 2003-Fenster.

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

Syntax

<GuidAttribute("096CD58B-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(WindowsCollectionClass))> _
Public Interface WindowsCollection
    Inherits Windows

Dim instance As WindowsCollection

[GuidAttribute("096CD58B-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(WindowsCollectionClass))] 
public interface WindowsCollection : Windows

Hinweise

Dies ist ein Wrapper für eine COM-Schnittstelle, die durch eine Coklasse implementiert wurde, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie den Coklasse umschließenden Typen, der von der Schnittstelle implementiert wird, um auf die in der Schnittstelle angegebenen Member zuzugreifen. Informationen zu dem Typ, einschließlich Verwendung, Hinweise und Beispiele, finden Sie unter Windows.

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.

Die WindowsCollection-Auflistung implementiert Eigenschaften, die den Zugriff auf die einem Formular zugeordneten Window-Objekte ermöglichen. Der Zugriff auf die Auflistung erfolgt über die Windows-Eigenschaft des Application-Objekts.

Hinweis:
Die WindowsCollection-Auflistung kann nur verwendet werden, um die Anzahl der in der Auflistung enthaltenen WindowObject-Objekte abzurufen oder um einen Verweis auf das angegebene WindowObject-Objekt zurückzugeben. Sie kann nicht zum Erstellen, Hinzufügen oder Entfernen von WindowObject-Objekten verwendet werden.

Beispiel

Im folgenden Beispiel, das als OnClick-Ereignishandler für eine Schaltfläche in einem Formular implementiert ist, dient die Windows-Eigenschaft des Application-Objekts zum Festlegen eines Verweises auf die WindowsCollection-Auflistung. Anschließend durchläuft der Code die Auflistung in einer Schleife und zeigt den positionellen Index und den Namen jedes in der Auflistung enthaltenen Window-Objekts an:

public void ShowWindowTypes_OnClick(DocActionEvent e)
{
// Set a reference to the Windows collection.
WindowsCollection windows = thisApplication.Windows;

// Loop through the collection and display the type
// of each Window object that it contains.
for (int i=0; i < windows.Count; i++)
 {
string windowType = "";

switch (windows[i].WindowType)
    {
    case XdWindowType.xdEditorWindow:
    windowType = "Editing window";
    break;

    case XdWindowType.xdDesignerWindow:
    windowType = "Designing window";
    break;
    }

thisXDocument.UI.Alert("Window type " + i + ": " + windowType);
 }
}

Weitere Codebeispiele finden Sie unter Vorgehensweise: Arbeiten mit Formularfenstern.

Siehe auch

Referenz

WindowsCollection-Member
Microsoft.Office.Interop.InfoPath-Namespace