WindowsCollection, interface

Contient un objet WindowObject pour chaque fenêtre Microsoft Office InfoPath 2003 actuellement ouverte.

Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans microsoft.office.interop.infopath.dll)

Syntaxe

<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

Remarques

Ce type est le wrapper d'une interface COM implémentée par une classe de composants (coclass) qui est requise par le code managé pour l'interopérabilité COM. Pour accéder aux membres spécifiés par cette interface, utilisez le type qui enveloppe la classe de composants implémentant cette interface. Pour plus d'informations sur ce type, notamment son utilisation, des remarques et des exemples, voir Windows.

Les objets WindowObject représentent les deux types de fenêtres qui sont utilisées dans l'application InfoPath : la fenêtre d'édition, utilisée comme zone de formulaire lorsqu'un utilisateur remplit un formulaire et la fenêtre de création, utilisée en mode Création lorsqu'un utilisateur crée un formulaire.

La collection WindowsCollection implémente des propriétés qui permettent d'accéder aux objets Window associés à un formulaire et est accessible via la propriété Windows de l'objet Application.

Remarque
La collection WindowsCollection peut être utilisée pour compter le nombre d'objets WindowObject qu'elle contient ou pour renvoyer une référence à un objet WindowObject spécifié. Elle ne peut pas être utilisée pour créer, ajouter ou supprimer des objets WindowObject.

Exemple

Dans l'exemple suivant, implémenté comme un gestionnaire d'événements OnClick pour un bouton figurant sur un formulaire, la propriété Windows de l'objet Application est utilisée pour définir une référence à la collection WindowsCollection. Le code exécute ensuite une boucle dans la collection et affiche le type de chaque objet Window qu'elle contient.

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);
 }
}

Pour des exemples de codes, voir Procédure : utiliser des fenêtres de formulaires.

Voir aussi

Référence

Membres WindowsCollection
Microsoft.Office.Interop.InfoPath, espace de noms