Partager via


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

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 de Microsoft UI Automation pour le type de contrôle Menu. Il décrit l'arborescence Microsoft UI Automation du contrôle et fournit les propriétés et modèles de contrôle pour des scénarios de contrôle spécifiques.

Un contrôle de menu permet une organisation hiérarchique des éléments associés aux commandes et gestionnaires d'événements. Dans une application Microsoft Windows type, une barre de menus contient plusieurs boutons de menu (tels que Fichier, Modifier et Fenêtre), et chaque bouton de menu affiche un menu. Un menu contient une collection d'éléments de menu (tels que Nouveau, Ouvrir et Fermer) qui peuvent être développés pour afficher des éléments de menu supplémentaires ou pour exécuter une action spécifique lorsque l'utilisateur clique dessus.

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 Menu. 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 menu 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

Menu

  • MenuItem (1 ou plusieurs)

Non applicable (à moins que le contrôle de menu soit un menu contextuel parent d'un objet qui n'est pas un élément de menu)

  • MenuItem (1 ou plusieurs)

Les contrôles de menu apparaissent toujours dans l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation. Les types de contrôle Menu doivent apparaître sous le contrôle auquel leurs informations font référence. Les clients UI Automation doivent écouter MenuOpenedEvent pour s'assurer d'obtenir régulièrement les informations acheminées par les contrôles de menu. Les contrôles de menu contextuel constituent un cas particulier. Ils apparaissent comme enfants du Bureau.

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 le type de contrôle Menu. 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

NameProperty

Pas de prise en charge

Le contrôle de menu ne requiert pas qu'une propriété Name soit définie.

LabeledByProperty

Null

Aucune étiquette n'est prévue avec un contrôle de menu typique.

ControlTypeProperty

Menu

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

IsContentElementProperty

False

Le contrôle de menu n'est pas inclus dans l'affichage du contenu de l'arborescence UI Automation.

IsControlElementProperty

True

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

Modèles de contrôle UI Automation requis

Aucun modèle de contrôle n'est requis pour le type de contrôle Menu.

Événements UI Automation requis

Les contrôles de menu doivent déclencher MenuOpenedEvent lorsqu'ils s'affichent à l'écran. MenuOpenedEvent inclura le texte du contrôle. MenuClosedEvent doit être déclenché lorsqu'un menu disparaît de l'écran.

Le tableau suivant répertorie les événements UI Automation qui doivent être pris en charge par tous les contrôles de menu. 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

MenuOpenedEvent

Obligatoire

Aucun

MenuClosedEvent

Obligatoire

Aucun

É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

AutomationFocusChangedEvent

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Voir aussi

Référence

Menu

Concepts

Vue d'ensemble des modèles de contrôle UI Automation

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

Vue d'ensemble d'UI Automation