Implémentation du modèle de contrôle Window d'UI Automation

Article
09/04/2008

Mise à jour : novembre 2007

Cette rubrique présente les conventions et instructions à respecter pour implémenter IWindowProvider, notamment des informations sur les propriétés, les méthodes et les événements WindowPattern. Des liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.

Le modèle de contrôle WindowPattern est utilisé pour prendre en charge des contrôles qui fournissent les fonctionnalités fondamentales des fenêtres dans une interface graphique utilisateur (GUI, Graphical User Interface) traditionnelle. Parmi les contrôles qui doivent implémenter ce modèle de contrôle figurent des fenêtres d'application de niveau supérieur, des fenêtres enfants interface multidocument (MDI, Multiple-Document Interface), des contrôles de volet de fractionnement redimensionnables, des boîtes de dialogue modales et des fenêtres d'aide bulle.

Cette rubrique comprend les sections suivantes.

Conventions et instructions de l'implémentation
Membres requis pour IWindowProvider
Exceptions
Rubriques connexes

Conventions et instructions de l'implémentation

Lorsque vous implémentez le modèle de contrôle Window, notez les conventions et instructions suivantes :

Pour prendre en charge la capacité à modifier la taille de la fenêtre et la position de l'écran à l'aide d'UI Automation, un contrôle doit implémenter ITransformProvider en plus de IWindowProvider.
Les contrôles qui contiennent des barres de titre et des éléments de barre de titre qui permettent au contrôle d'être déplacé, redimensionné, agrandi, réduit ou fermé sont en général requis pour implémenter IWindowProvider.
En général, les contrôles tels que les info-bulles contextuelles, les zones de liste déroulante ou les menus déroulants n'implémentent pas IWindowProvider.
Les fenêtres d'aide bulle sont différentes des info-bulles contextuelles de base de par la présence du bouton Fermer, similaire à une fenêtre.
Le mode Plein écran n'est pas pris en charge par IWindowProvider étant donné que cette fonctionnalité est spécifique à une application et ne correspond pas au comportement type d'une fenêtre.

Membres requis pour IWindowProvider

Les propriétés, méthodes et événements suivants sont requis pour l'interface IWindowProvider.

Membre requis	Type de membre	Remarques
InteractionState	Propriété	Aucune
IsModal	Propriété	Aucune
IsTopmost	Propriété	Aucune
Maximizable	Propriété	Aucune
Minimizable	Propriété	Aucune
VisualState	Propriété	Aucune
Close	Méthode	Aucune
SetVisualState	Méthode	Aucune
WaitForInputIdle	Méthode	Aucune
WindowClosedEvent	Événement	Aucune
WindowOpenedEvent	Événement	Aucune
WindowInteractionState	Événement	N'est pas forcément ReadyForUserInteraction

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d'exception	Condition
InvalidOperationException	SetVisualState Lorsqu'un contrôle ne prend pas en charge un comportement demandé.
ArgumentOutOfRangeException	WaitForInputIdle Lorsque le paramètre n'est pas un nombre valide.

InvalidOperationException

SetVisualState