Prise en charge d'UI Automation pour le type de contrôle MenuBar
Notes
Cette documentation s’adresse 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 dernières informations sur UI Automation, consultez API Windows Automation : UI Automation.
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 pour pouvoir utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions spécifiques pour la structure d’arborescence, les valeurs de propriété et les modèles de contrôle d’IU Automation.
Les contrôles de barre de menu constituent un exemple de contrôles qui implémentent le type de contrôle MenuBar. Les barres de menus permettent aux utilisateurs d’activer les commandes et les options contenues dans une application.
Les sections suivantes définissent l’arborescence, les propriétés, les modèles de contrôle et les événements de l’IU Automation nécessaires pour le type de contrôle Barre de menus. Les exigences UI Automation s’appliquent à tous les contrôles de liste, que ce soit Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Arborescence UI Automation obligatoire
Le tableau suivant représente l’affichage de contrôle et l’affichage du contenu de l’arborescence UI Automation relative aux contrôles de barre de menus. En outre, il décrit ce que peut contenir chaque affichage. Pour plus d’informations sur l’arborescence de l’IU Automation, consultez Vue d’ensemble de l’arborescence de l’IU Automation.
| Affichage de contrôle | Affichage de 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 tels que des contrôles d’édition et des zones de liste modifiable dans leur structure. Ces contrôles supplémentaires correspondent aux « autres contrôles » répertoriés ci-dessus dans les affichages de contrôle et de contenu.
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 adaptée aux 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 | Notes |
|---|---|---|
| BoundingRectangleProperty | Consultez les remarques. | La valeur exposée par cette propriété doit inclure tous les contrôles qu’elle contient. |
| NameProperty | Consultez les remarques. | Le contrôle de barre de menus n’a pas besoin d’un nom, sauf si une application contient plusieurs barres de menus. S’il existe plusieurs barres de menus dans une application, 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 identique 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 du contrôle de l’arborescence UI Automation. |
| IsOffscreenProperty | Consultez les remarques. | La valeur de cette propriété varie selon que le contrôle est visible ou non à l’écran. |
| OrientationProperty | Dépend | Cette propriété indique si le contrôle de barre de menus est horizontal ou vertical. |
| IsKeyboardFocusableProperty | True | Les contrôles de barre de menus sont actifs via le clavier, car les contrôles qu’ils contiennent peuvent recevoir le focus clavier. |
| HelpTextProperty | Consultez les remarques. | Aucun scénario ne s’applique si du texte d’aide est nécessaire pour un contrôle de barre de menus. |
| AcceleratorKeyProperty | Null |
Les barres de menus n’ont jamais de touche accélérateur. |
| AccessKeyProperty | « ALT » | La touche ALT doit toujours apporter le focus à la barre de menus de l’application. |
Modèles de contrôle UI Automation obligatoires
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 UI Automation Control Patterns Overview.
| Modèle de contrôle | Support | Notes |
|---|---|---|
| IExpandCollapseProvider | Dépend | Si le contrôle peut être développé ou réduit, implémentez IExpandCollapseProvider. |
| IDockProvider | Dépend | Si le contrôle peut être ancré aux différentes parties de l’écran, implémentez IDockProvider. |
| ITransformProvider | Dépend | Si le contrôle peut être redimensionné, pivoté ou déplacé, il doit implémenter ITransformProvider. |
Événements UI Automation obligatoires
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 UI Automation Events Overview.
| Événement UI Automation | Prise en charge/valeur | Notes |
|---|---|---|
| Événement de modification de propriétéBoundingRectangleProperty | Obligatoire | None |
| Événement de modification de propriétéIsOffscreenProperty | Obligatoire | None |
| Événement de modification de propriétéIsEnabledProperty | Obligatoire | None |
| Événement de modification de propriétéExpandCollapseStateProperty | Dépend | None |
| AutomationFocusChangedEvent | Obligatoire | None |
| StructureChangedEvent | Obligatoire | None |