Partager via


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

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 TitleBar. 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 instructions spécifiques pour l'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 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 TitleBar. Les spécifications UI Automation s'appliquent à tous les contrôles de barre de titre, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32ou 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 représente l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles de barre de titre et décrit ce qui peut être inclus dans chaque affichage. 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

TitleBar

  • Menu (0 ou 1)

  • Bouton (0 ou plus)

Non applicable. (le contrôle de barre de titre n'a aucun contenu.)

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 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

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 englobant d'une barre de titre doit comprendre tous les contrôles qui y sont inclus.

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

IsKeyboardFocusableProperty

False

Les barres de titre n'ont jamais le focus clavier.

NameProperty

""

La barre de titre n'est pas un contenu ; ses informations textuelles sont exposées sur la fenêtre parente.

LabeledByProperty

Consulter les remarques.

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

False

Le contrôle de barre de titre n'est jamais un contenu.

IsControlElementProperty

True

Le contrôle de barre de titre doit toujours être un contrôle.

IsOffscreenProperty

Selon le cas

Ce contrôle retournera une valeur selon si la barre de titre est visible sur 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ès rapide.

AccessKeyProperty

""

Le contrôle de barre de titre n'a pas de touche d'accès rapide.

Modèles de contrôle UI Automation requis

Le type de contrôle TitleBar n'est pas requis pour prendre en charge tous modèles de contrôles. Ses fonctionnalités sont exposées à travers le modèle de contrôle Window sur le contrôle Window.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation requis afin d'ê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

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.

Jamais

Aucun

AutomationFocusChangedEvent

Jamais

Aucun

StructureChangedEvent

Obligatoire

Aucun

Voir aussi

Référence

TitleBar

Concepts

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

Vue d'ensemble d'UI Automation