Partager via

Implémentation du modèle de contrôle de fenêtre UI Automation

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent 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.

Cette rubrique présente des instructions et des conventions pour l’implémentation IWindowProvider, y compris des informations sur WindowPattern les propriétés, les méthodes et les événements. Les liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.

Le WindowPattern modèle de contrôle est utilisé pour prendre en charge les contrôles qui fournissent des fonctionnalités fondamentales basées sur des fenêtres au sein d’une interface utilisateur graphique traditionnelle (GUI). Parmi les exemples de contrôles qui doivent implémenter ce modèle de contrôle, citons les fenêtres d’application de niveau supérieur, les fenêtres enfants MDI (Multiple Document Interface), les contrôles de volet fractionné redimensionnables, les boîtes de dialogue modales et les fenêtres d’aide à bulle.

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle Window, notez les instructions et conventions suivantes :

  • Pour prendre en charge la possibilité de modifier à la fois la taille de 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 généralement nécessaires pour implémenter IWindowProvider.

  • Les contrôles tels que les fenêtres contextuelles d’info-bulle et la zone de liste déroulante ou les menus déroulants ne sont généralement pas implémentés IWindowProvider.

  • Les fenêtres d’aide aux bulles sont différenciées des fenêtres contextuelles d’info-bulle de base par l’approvisionnement d’un bouton Fermer de type fenêtre.

  • Le mode plein écran n’est pas pris en charge par IWindowProvider, car il est propre à une application et n’est pas un comportement de fenêtre classique.

Membres obligatoires pour IWindowProvider

Les propriétés, méthodes et événements suivants sont nécessaires 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 garanti ReadyForUserInteraction

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d’exception État
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.

Voir aussi