WindowObject, interface

Article
04/27/2010

Représente une fenêtre utilisée dans l'application Microsoft Office InfoPath 2007.

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

Syntaxe

<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(WindowObjectWrapper))> _
<GuidAttribute("096cd5f7-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface WindowObject
    Inherits Window2, Window

Dim instance As WindowObject

[CLSCompliantAttribute(false)] 
[CoClassAttribute(typeof(WindowObjectWrapper))] 
[GuidAttribute("096cd5f7-0786-11d1-95fa-0080c78ee3bb")] 
public interface WindowObject : Window2, Window

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir Window2.

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.

L'objet WindowObject fournit un certain nombre de propriétés et de méthodes qui peuvent être utilisées pour interagir avec des fenêtres InfoPath, par exemple, pour activer ou fermer une fenêtre et interagir avec les volets Office et les barres de commande qu'ils contiennent. L'objet WindowObject fournit également une propriété permettant d'accéder au document XML sous-jacent du formulaire associé à la fenêtre.

Les objets WindowObject d'un formulaire InfoPath sont accessibles via la propriété Item. Le type de fenêtre peut être déterminé à l'aide de la propriété WindowType.

Vous pouvez accéder directement à la fenêtre ouverte à l'aide de la propriété ActiveWindow de l'objet Application, sans passer par la collection WindowsCollection. Vous pouvez également accéder à l'objet WindowObject associé à une vue en utilisant la propriété Window.

Remarque
Certaines propriétés de l'objet WindowObject ne sont disponibles que lors de l'utilisation du type de fenêtre d'édition ; elles renvoient une erreur si elles sont utilisées avec le type de fenêtre de création.

Exemple

Dans l'exemple suivant, implémenté comme un gestionnaire d'événements OnClick pour un bouton figurant sur un formulaire, la propriété ActiveWindow est utilisée pour définir une référence à la fenêtre active. Le code vérifie ensuite le type de fenêtre ; s'il s'agit de la fenêtre d'édition, il affiche le nombre de volets Office contenus dans la fenêtre dans une boîte de message.

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

Pour des exemples de code, voir Utilisation de Form Windows avec le modèle objet InfoPath 2003.

Voir aussi

Référence

Membres WindowObject
Microsoft.Office.Interop.InfoPath.SemiTrust, espace de noms

Partager via