Partage via

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

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 ToolBar. 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 de propriété UI Automation et les modèles de contrôle. Les contrôles de barre d’outils permettent aux utilisateurs finaux d’activer des commandes et des outils contenus dans une application.

Les sections suivantes définissent la structure d’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation requis pour le type de contrôle ToolBar. Les exigences UI Automation s’appliquent à tous les contrôles de barre d’outils, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre la vue de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de barre d’outils 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
Barre des outils

- Différents contrôles (0 ou plus)		 Barre des outils

- Différents contrôles (0 ou plus)

Un contrôle de barre d’outils peut contenir tout type de contrôle dans sa sous-arborescence. Ils contiennent le plus souvent des boutons, des zones de liste déroulante et des boutons fractionnés.

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 barre d’outils. 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. Prise en charge s’il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez remplacer et fournir un point interactif.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Dépend Le contrôle de barre d’outils n’a pas besoin d’un nom, sauf si plusieurs d’entre eux sont utilisés dans une application. Si plusieurs éléments sont présents, chacun doit avoir un nom distinctif (par exemple, Mise en forme ou Structure).
LabeledByProperty Null Les contrôles de barre d’outils n’ont jamais d’étiquette.
ControlTypeProperty Barre des outils Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « barre d’outils » Chaîne localisée correspondant au type de contrôle ToolBar.
IsContentElementProperty Vrai Le contrôle de barre d’outils correspond toujours à un contenu.
IsControlElementProperty Vrai Le contrôle de barre d’outils doit toujours être un contrôle.

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 barre d’outils. 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
ExpandCollapsePattern Dépend Si la barre d’outils peut être développée et réduite pour afficher plus d’éléments, elle doit prendre en charge ce modèle.
DockPattern Dépend Si la barre d’outils peut être ancrée dans différentes parties de l’écran, elle doit prendre en charge ce modèle.
TransformPattern Dépend Si la barre d’outils peut être redimensionnée, pivotée ou déplacée, elle doit prendre en charge ce modèle.

É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 barre d’outils. Pour plus d’informations sur les événements, consultez vue d’ensemble des événements UI Automation.

Événement UI Automation Soutien Remarques
Événement de modification de la propriété BoundingRectangleProperty. Obligatoire Aucun
Événement de modification de la propriété IsOffscreenProperty. Obligatoire Aucun
Événement de modification de la propriété IsEnabledProperty. Obligatoire Aucun
Événement de modification de la propriété ExpandCollapseStateProperty. Dépend Aucun
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi

  • Last updated on