Partager via


Type de contrôle menu

Cette rubrique fournit des informations sur la prise en charge de Microsoft UI Automation pour le type de contrôle Menu.

Un contrôle menu permet une organisation hiérarchique des éléments associés à des commandes et des gestionnaires d’événements. Dans une application Microsoft Windows classique, une barre de menus contient plusieurs boutons de menu (tels que Fichier, Edition et Fenêtre) et chaque bouton de menu affiche un menu. Un menu contient un groupe d’éléments de menu (tels que Nouveau, Ouvriret Fermer), qui peuvent être développés pour afficher des éléments de menu supplémentaires ou pour exécuter une action spécifique quand vous cliquez dessus.

Les sections suivantes définissent les UI Automation l’arborescence, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle Menu. Les exigences UI Automation s’appliquent à tous les contrôles de menu où l’infrastructure/plateforme de l’interface utilisateur intègre UI Automation prise en charge des types de contrôles et des modèles de contrôle.

Cette rubrique contient les sections suivantes.

Arborescence standard

Le tableau suivant illustre une vue de contrôle et de contenu classique de l’arborescence UI Automation qui se rapporte aux contrôles de menu 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.

Affichage de contrôle Affichage de contenu
  • Menu
    • MenuItem (1 ou plusieurs)
    • Autres contrôles (0 ou plusieurs)
  • Menu
    • MenuItem (1 ou plusieurs)
    • Autres contrôles (0 ou plusieurs)

 

Les contrôles menu apparaissent toujours dans l’affichage de contrôle et l’affichage du contenu de l’arborescence UI Automation. Les contrôles de menu doivent apparaître sous le contrôle auquel leurs informations font référence. UI Automation clients peuvent écouter UIA_MenuOpenedEventId pour s’assurer qu’ils obtiennent systématiquement des informations transmises par les contrôles de menu. Les contrôles de menu contextuel constituent un cas particulier. Ils peuvent apparaître en tant qu’enfants du bureau ou d’une fenêtre d’application de niveau supérieur.

Un contrôle de menu peut contenir d’autres contrôles, tels que des contrôles d’édition et des zones de liste déroulante, dans sa structure. Ces contrôles supplémentaires correspondent aux « autres contrôles » répertoriés dans le tableau précédent dans les vues de contrôle et de contenu.

Propriétés pertinentes

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 UI Automation propriétés, consultez Récupération de propriétés à partir d’éléments UI Automation.

Propriété UI Automation Valeur Notes
UIA_ControlTypePropertyId Menu
UIA_IsContentElementPropertyId true Le contrôle de menu est toujours inclus dans l’affichage du contenu de l’arborescence UI Automation.
UIA_IsControlElementPropertyId true Le contrôle menu est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
UIA_LabeledByPropertyId NULL Aucune étiquette n’est censée accompagner un contrôle menu standard.
UIA_NamePropertyId Consultez les remarques. Le contrôle de menu ne nécessite pas la définition d’une propriété Name , ou il peut avoir le même nom que le contrôle associé, tel qu’un élément de menu qui a ouvert le sous-menu.

 

Modèles de contrôle requis

Il n’existe aucun modèle de contrôle obligatoire pour le type de contrôle Menu.

Événements obligatoires

Les contrôles de menu doivent déclencher l’événement UIA_MenuOpenedEventId lorsqu’ils s’affichent à l’écran. L’événement UIA_MenuOpenedEventId inclut le texte du contrôle. L’événement UIA_MenuClosedEventId doit être déclenché lorsqu’un menu disparaît de l’écran.

Le tableau suivant répertorie les événements UI Automation que les contrôles de menu doivent prendre en charge. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.

Événement UI Automation Notes
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId’événement de modification de propriété.
UIA_IsEnabledPropertyId événement de modification de propriété. Si le contrôle prend en charge la propriété IsEnabled , il doit prendre en charge cet événement.
UIA_IsOffscreenPropertyId événement de modification de propriété. Si le contrôle prend en charge la propriété IsOffscreen , il doit prendre en charge cet événement.
UIA_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Conceptuel

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

Vue d'ensemble d'UI Automation