WindowsCollection-Schnittstelle

Artikel
04/27/2010

Enthält ein WindowObject-Objekt für jedes Microsoft Office InfoPath 2007-Fenster, das zurzeit geöffnet ist.

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

Syntax

<GuidAttribute("096cd58b-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(WindowsCollectionWrapper))> _
<CLSCompliantAttribute(False)> _
Public Interface WindowsCollection
    Inherits Windows

Dim instance As WindowsCollection

[GuidAttribute("096cd58b-0786-11d1-95fa-0080c78ee3bb")] 
[CoClassAttribute(typeof(WindowsCollectionWrapper))] 
[CLSCompliantAttribute(false)] 
public interface WindowsCollection : Windows

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, 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:

[InfoPathEventHandler(MatchPath="ShowWindowTypes", EventType=InfoPathEventType.OnClick)]
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);
 }
}

Codebeispiele finden Sie unter Vorgehensweise: Arbeiten mit Formularfenstern mithilfe des InfoPath 2003-Objektmodells.

Siehe auch

Referenz

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

Freigeben über