Partager via


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

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 MenuBar. 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ôle .

Les contrôles de barre de menus sont un exemple de contrôles qui implémentent le type de contrôle MenuBar. Les barres de menus fournissent aux utilisateurs un moyen d'activer les commandes et les options contenues 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 MenuBar. Les spécifications UI Automation s'appliquent à tous les contrôles de liste, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou 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 menus 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

MenuBar

  • MenuItem (1 ou plus)

  • Autres contrôles (0 ou plusieurs)

MenuBar

  • MenuItem (1 ou plus)

  • Autres contrôles (0 ou plusieurs)

Les contrôles de barre de menus peuvent contenir d'autres contrôles dans leur structure, tels que les contrôles d'édition et les zones de liste déroulante. Ces contrôles supplémentaires correspondent aux « autres contrôles » répertoriés ci-dessus dans les affichages de contrôle et du 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 de barre de menus. 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

BoundingRectangleProperty

Consulter les remarques.

La valeur exposée par cette propriété doit inclure tous les contrôles qu'elle contient.

NameProperty

Consulter les remarques.

Le contrôle de barre de menus n'a pas besoin de nom, à moins qu'une application dispose de plusieurs barres de menus. Si une application contient plusieurs barres de menus, alors cette propriété doit être utilisée pour exposer des noms distinctifs, tels que « Mise en forme » ou « Mode Plan ».

LabeledByProperty

Null

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

ControlTypeProperty

MenuBar

Cette valeur est la même pour toutes les infrastructures d'interface utilisateur.

LocalizedControlTypeProperty

"barre de menus"

Chaîne localisée correspondant au type de contrôle MenuBar.

IsContentElementProperty

True

Le contrôle de barre de menus est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.

IsControlElementProperty

True

Le contrôle de barre de menus est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.

IsOffscreenProperty

Consulter les remarques.

La valeur de cette propriété varie selon que le contrôle peut s'afficher à l'écran ou non.

OrientationProperty

Selon le cas

Cette propriété expose si le contrôle de barre de menus est horizontal ou vertical.

IsKeyboardFocusableProperty

True

Les contrôles de barre de menus peuvent être désignés comme éléments actifs via le clavier car les contrôles qu'ils contiennent peuvent prendre le focus clavier.

HelpTextProperty

Consulter les remarques.

Aucun scénario lorsque le texte d'aide est requis pour un contrôle de barre de menus.

AcceleratorKeyProperty

Null

Les barres de menus n'ont jamais de touches accélérateur.

AccessKeyProperty

"ALT"

Dans l'application, le fait d'appuyer sur la touche ALT doit toujours apporter le focus à la barre de menus.

Modèles de contrôle UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par les contrôles de barre de menus. 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

IExpandCollapseProvider

Selon le cas

Si le contrôle peut être développé ou réduit, implémentez IExpandCollapseProvider.

IDockProvider

Selon le cas

Si le contrôle peut être ancré aux différentes parties de l'écran, implémentez IDockProvider.

ITransformProvider

Selon le cas

Si le contrôle peut être redimensionné, pivoté ou déplacé, il doit implémenter ITransformProvider.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation qui doivent être pris en charge par tous les contrôles de barre de menus. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.

Événement UI Automation

Prise en charge/Valeur

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

MenuBar

Concepts

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

Vue d'ensemble d'UI Automation