Partager via

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

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 de l'UI Automation pour le type de contrôle « TitleBar ». 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 de titre représentent des titres ou des barres de légende dans une fenêtre.

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 TitleBar. Les exigences UI Automation s’appliquent à tous les contrôles de barre de titre, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et l’affichage de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de barre de titre 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
TitleBar

- Menu (0 ou 1)
- Bouton (0 ou plus)		 Non applicable. (Le contrôle de barre de titre ne comporte aucun contenu.)

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 TitleBar. 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. Le rectangle englobant d’une barre de titre doit englober tous les contrôles qu’il contient.
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 Faux Les barres de titre n’ont jamais le focus clavier.
NameProperty "" La barre de titre ne représente pas du contenu. Ses informations textuelles sont exposées dans la fenêtre parente.
LabeledByProperty Consultez les notes. Le contrôle de barre de titre n’a généralement pas d’étiquette.
ControlTypeProperty TitleBar Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « barre de titre » Chaîne localisée correspondant au type de contrôle TitleBar.
IsContentElementProperty Faux Le contrôle de barre de titre ne représente jamais du contenu.
IsControlElementProperty Vrai Le contrôle de barre de titre doit toujours être un contrôle.
IsOffscreenProperty Dépend Ce contrôle retourne une valeur selon que la barre de titre est visible à l’écran.
HelpTextProperty "" Il n’est pas nécessaire d’exposer le texte d’aide.
AcceleratorKeyProperty "" Les barres de titre n’ont jamais de touches d’accélérateur.
AccessKeyProperty "" Le contrôle de barre de titre n’a pas de touche d’accès.

Modèles de contrôle UI Automation obligatoires

Le type de contrôle TitleBar n’est pas nécessaire pour la prise en charge des modèles de contrôle. Ses fonctionnalités sont exposées via le modèle de contrôle Window sur le contrôle de 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 barre de titre. 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. Jamais Aucun
AutomationFocusChangedEvent Jamais Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi