Modèle de contrôle de fenêtre

  • Article

Décrit les instructions et conventions pour l’implémentation d’IWindowProvider, notamment des informations sur les propriétés, les méthodes et les événements. Le modèle de contrôle Fenêtre prend en charge les contrôles qui fournissent des fonctionnalités fondamentales basées sur une fenêtre au sein d’une interface utilisateur graphique traditionnelle.

Les contrôles qui doivent implémenter ce modèle de contrôle sont notamment les fenêtres d’application de niveau supérieur, les fenêtres enfants de l’interface multidocument (MDI), les contrôles de volet de fractionnement redimensionnables, les boîtes de dialogue modales et les fenêtres d’info-bulle. Pour obtenir des exemples de contrôles implémentant ce modèle de contrôle, consultez Control Pattern Mapping for UI Automation Clients.

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

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

  • Pour prendre en charge la possibilité de modifier la taille de la fenêtre et la position de l’écran à l’aide de Microsoft 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 requis pour implémenter IWindowProvider.
  • Les contrôles tels que les fenêtres contextuelles d’info-bulle et les listes déroulantes de zone de liste déroulante ou de menu n’implémentent généralement pas IWindowProvider.
  • Les fenêtres d’aide à bulles se distinguent des fenêtres contextuelles d’info-bulle de base par la mise en place d’un bouton Fermer semblable à une fenêtre.
  • Le mode plein écran n’est pas pris en charge par IWindowProvider , car il est spécifique aux fonctionnalités d’une application et n’est pas un comportement de fenêtre classique.

Membres requis pour IWindowProvider

Les propriétés, méthodes et événements suivants sont nécessaires pour implémenter l’interface IWindowProvider .

Membres nécessaires Type de membre Notes
WindowInteractionState Propriété Il n’est pas garanti d’être WindowInteractionState_ReadyForUserInteraction
IsModal Propriété Aucun
IsTopmost Propriété Aucun
CanMaximize Propriété Aucun
CanMinimize Propriété Aucun
WindowVisualState Propriété Aucun
Close Méthode Aucun
SetVisualState Méthode Aucun
WaitForInputIdle Méthode Aucun
UIA_Window_WindowClosedEventId Événement Aucun
UIA_Window_WindowOpenedEventId Événement Aucun

 

Conceptuel

Vue d'ensemble des modèles de contrôle UI Automation

Mappage de modèle de contrôle pour les clients UI Automation

Vue d’ensemble de l’arborescence UI Automation