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

Article
08/10/2011

Remarque
Cette documentation s'adresse aux développeurs .NET Framework qui veulent utiliser les classes UI Automation managées définies dans l'espace de noms System.Windows.Automation.Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation (page éventuellement en anglais).

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 graphical user interface (GUI) 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 multiple-document interface (MDI), 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é	Aucun
IsModal	Propriété	Aucun
IsTopmost	Propriété	Aucun
Maximizable	Propriété	Aucun
Minimizable	Propriété	Aucun
VisualState	Propriété	Aucun
Close	Méthode	Aucun
SetVisualState	Méthode	Aucun
WaitForInputIdle	Méthode	Aucun
WindowClosedEvent	Événement	Aucun
WindowOpenedEvent	Événement	Aucun
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