Partager via


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

RemarqueRemarque

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 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 afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôles. Les contrôles de barre d'outils permettent à l'utilisateur final d'activer les commandes et les outils contenus dans une application.

Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle ToolBar. Les spécifications UI Automation s'appliquent à tous les contrôles de barre d'outils, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou de Windows Forms.

Cette rubrique comprend les sections suivantes.

  • Arborescence UI Automation requise
  • Propriétés UI Automation requises
  • Modèles de contrôle UI Automation requis
  • Événements UI Automation requis
  • Rubriques connexes

Arborescence UI Automation requise

Le tableau suivant décrit l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles de barre d'outils et décrit ce qui peut être inclus dans chaque vue. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Affichage de contrôle

Affichage du contenu

Toolbar

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

Toolbar

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

Un contrôle de barre d'outils peut contenir n'importe quel type de contrôle dans son sous-arborescence. Ce contrôle contient le plus souvent des boutons, des zones de liste déroulantes et des boutons partagés.

Propriétés UI Automation requises

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

Consulter les remarques.

La valeur de cette propriété doit être unique dans tous les contrôles d'une application.

BoundingRectangleProperty

Consulter les remarques.

Le rectangle le plus éloigné qui contient l'ensemble du contrôle.

ClickablePointProperty

Consulter les remarques.

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 recherche spécialisé, vous devez substituer et fournir un point interactif.

IsKeyboardFocusableProperty

Consulter les remarques.

Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.

NameProperty

Selon le cas

Le contrôle de barre d'état n'a pas besoin d'un nom sauf si plusieurs barres sont utilisées dans une application. Si plusieurs contrôles sont présents, chacun doit avoir un nom distinctif (par exemple, Mise en forme ou Plan).

LabeledByProperty

Null

Les contrôles de barre d'outils n'ont jamais d'étiquette.

ControlTypeProperty

Toolbar

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

True

Le contrôle de barre d'outils correspond toujours à un contenu.

IsControlElementProperty

True

Le contrôle de barre d'outils doit toujours être un contrôle.

Modèles de contrôle UI Automation requis

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

Prise en charge

Remarques

ExpandCollapsePattern

Selon le cas

Si la barre d'outils peut être réduite et développée pour afficher plus d'éléments, elle doit alors prendre en charge ce modèle.

DockPattern

Selon le cas

Si la barre d'outils peut être ancrée dans différentes zones de l'écran, elle doit alors prendre en charge ce modèle.

TransformPattern

Selon le cas

Si la barre d'outils peut être redimensionnée, pivotée ou déplacée, elle doit alors prendre en charge ce modèle.

Événements UI Automation requis

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

Prise en charge

Remarques

Événement de modification de propriété BoundingRectangleProperty.

Obligatoire

Aucun

Événement de modification de propriété IsOffscreenProperty.

Obligatoire

Aucun

Événement de modification de propriété IsEnabledProperty.

Obligatoire

Aucun

Événement de modification de propriété ExpandCollapseStateProperty.

Selon le cas

Aucun

AutomationFocusChangedEvent

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Voir aussi

Référence

ToolBar

Concepts

Vue d'ensemble des types de contrôle UI Automation

Vue d'ensemble d'UI Automation