Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
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 Microsoft UI Automation pour le type de contrôle Menu. Il décrit la structure de l’arborescence Microsoft UI Automation du contrôle et fournit les propriétés et les modèles de contrôle pour des scénarios de contrôle spécifiques.
Un contrôle de menu permet l’organisation hiérarchique des éléments associés aux commandes et aux gestionnaires d’événements. Dans une application Microsoft Windows classique, une barre de menus contient plusieurs boutons de menu (tels que fichier, Modifieret fenêtre), et chaque bouton de menu affiche un menu. Un menu contient une collection d’éléments de menu (tels que Nouvelle, Ouvriret Fermer), qui peuvent être développés pour afficher des éléments de menu supplémentaires ou pour effectuer une action spécifique en cliquant sur.
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 Menu. Les exigences UI Automation s’appliquent à tous les contrôles de liste, 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 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) |
Non applicable (sauf si le contrôle de menu est un menu contextuel qui est 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 dans l’affichage de contenu de l’arborescence UI Automation. Les types de contrôles de 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 qu’ils obtiennent constamment des informations transmises par les contrôles de menu. Les contrôles de menu contextuel sont un cas particulier. Ils apparaissent en tant qu’enfants du Bureau.
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 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 | Non pris en charge | Le contrôle de menu ne nécessite pas de définition d’une propriété Name. |
| LabeledByProperty | Null |
Aucune étiquette n’est prévue avec un contrôle de menu classique. |
| ControlTypeProperty | Menu | Cette valeur est la même pour toutes les infrastructures d’interface utilisateur. |
| IsContentElementProperty | Faux | Le contrôle de menu n’est pas inclus dans la vue de contenu de l’arborescence UI Automation. |
| IsControlElementProperty | Vrai | Le contrôle de menu est toujours inclus dans l’affichage contrôle de l’arborescence UI Automation. |
Modèles de contrôle UI Automation obligatoires
Il n’existe aucun modèle de contrôle requis pour le type de contrôle Menu.
Événements UI Automation obligatoires
Les contrôles de menu doivent être activés MenuOpenedEvent lorsqu’ils apparaissent à l’écran. Le MenuOpenedEvent texte du contrôle est inclus. Le MenuClosedEvent menu doit être déclenché lorsqu’un menu disparaît de l’écran.
Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles de menu. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.
| Événement UI Automation | Prise en charge/valeur | Remarques |
|---|---|---|
| MenuOpenedEvent | Obligatoire | Aucun |
| MenuClosedEvent | Obligatoire | Aucun |
| É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. | Obligatoire | Aucun |
| AutomationFocusChangedEvent | Obligatoire | Aucun |
| StructureChangedEvent | Obligatoire | Aucun |