Partager via

Prise en charge d'UI Automation pour le type de contrôle Window

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 fournit des informations sur la prise en charge d’UI Automation pour le type de contrôle Window. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs des propriétés UI Automation et les modèles de contrôle.

Le contrôle de fenêtre se compose du cadre de fenêtre, qui contient des objets enfants tels que la barre de titre, le client et d’autres objets.

Les exigences UI Automation des sections suivantes s’appliquent à tous les contrôles qui implémentent le type de contrôle Window, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de fenêtre et décrit ce qui peut être contenu dans chaque vue. Pour plus d’informations sur l’arborescence UI Automation, consultez vue d’ensemble de l’arborescence UI Automation.

Vue contrôle Affichage de contenu
Fenêtre Fenêtre

Propriétés UI Automation obligatoires

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles de fenêtre. Pour plus d’informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation Valeur Remarques
AutomationIdProperty Consultez les notes. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les notes. Le contrôle de fenêtre doit avoir un point cliquable qui entraîne la sélection ou l’annulation de la sélection de la fenêtre.
ControlTypeProperty Fenêtre Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
IsContentElementProperty Vrai Le contrôle de fenêtre doit toujours être du contenu.
IsControlElementProperty Vrai Le contrôle de fenêtre doit toujours être un contrôle.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
LabeledByProperty null Les contrôles de fenêtre n’ont pas d’étiquette de fenêtre statique.
LocalizedControlTypeProperty « fenêtre » Chaîne localisée correspondant au type de contrôle de fenêtre.
NameProperty Consultez les notes. Le contrôle de fenêtre contient toujours un élément principal de fenêtre, correspondant à ce que l'utilisateur associerait comme l'identificateur le plus sémantique de l'élément.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par les contrôles de fenêtre. Pour plus d’informations sur les modèles de contrôle, consultez Vue d’ensemble des modèles de contrôle UI Automation.

Modèle de contrôle Soutien Remarques
IDockProvider Conditionnelle Doit être pris en charge si la fenêtre a la capacité d’être ancrée.
ITransformProvider Obligatoire Permet à la fenêtre d’être déplacée, redimensionnée ou pivotée sur l’écran.
IWindowProvider Obligatoire Active des opérations spécifiques pour la fenêtre.

Événements UI Automation obligatoires

Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles de fenêtre. Pour plus d’informations sur les événements, consultez Vue d’ensemble des événements UI Automation.

Événement UI Automation Soutien Remarques
AsyncContentLoadedEvent Obligatoire Aucun
AutomationFocusChangedEvent Obligatoire Aucun
Événement de modification de la propriété BoundingRectangleProperty. Obligatoire Aucun
Événement de modification de la propriété IsEnabledProperty. Obligatoire Aucun
Événement de modification de la propriété IsOffscreenProperty. Obligatoire Aucun
LayoutInvalidatedEvent Obligatoire Aucun
Événement de modification de la propriété NameProperty. Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun
Événement de modification de la propriété HorizontallyScrollableProperty. Dépend Aucun
Événement de modification de la propriété HorizontalScrollPercentProperty. Dépend Aucun
Événement de modification de la propriété HorizontalViewSizeProperty. Dépend Aucun
Événement de modification de la propriété VerticalScrollPercentProperty. Dépend Aucun
Événement de modification de la propriété VerticallyScrollableProperty. Dépend Aucun
Événement de modification de la propriété VerticalViewSizeProperty. Dépend Aucun
WindowClosedEvent Obligatoire Aucun
WindowOpenedEvent Obligatoire Aucun
Événement de modification de la propriété WindowVisualStateProperty. Dépend Aucun

Voir aussi