Ui Automation-ondersteuning voor het menuItem-besturingselementtype
Notitie
Deze documentatie is bedoeld voor .NET Framework-ontwikkelaars die de beheerde UI Automation-klassen willen gebruiken die zijn gedefinieerd in de System.Windows.Automation naamruimte. Zie Windows Automation-API: UI Automation voor de meest recente informatie over UI Automation.
Dit onderwerp bevat informatie over microsoft UI Automation-ondersteuning voor het menuitem-besturingselementtype. Hierin wordt de structuur van de Microsoft UI Automation-structuur van het besturingselement beschreven en worden de eigenschappen en besturingspatronen geboden die vereist zijn voor het type MenuItem-besturingselement.
Met een menubeheer kunt u hiërarchische organisatie van elementen die zijn gekoppeld aan opdrachten en gebeurtenis-handlers. In een typische Microsoft Windows-toepassing bevat een menubalk verschillende menu-items (zoals Bestand, Bewerken en Venster) en elke menuopdracht geeft een menu weer. Een menu bevat een verzameling menu-items (zoals Nieuw, Openen en Sluiten), die kan worden uitgevouwen om extra menu-items weer te geven of een specifieke actie uit te voeren wanneer erop wordt geklikt. Een menu-item kan worden gehost in een menu, menubalk of werkbalk.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen gedefinieerd voor het type MenuItem-besturingselement. De vereisten voor UI Automation zijn van toepassing op alle lijstbesturingselementen, ongeacht of Windows Presentation Foundation (WPF), Win32 of Windows Forms.
Vereiste structuur van ui-automatiseringsstructuur
In de volgende tabel ziet u de besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op besturingselementen voor menu-items en wordt beschreven wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | Inhoudsweergave |
|---|---|
MenuItem 'Help'
|
MenuItem 'Help' - MenuItem "Help-onderwerpen" - MenuItem 'Info over Kladblok' |
De besturingselementweergave van het besturingselement voor menu-items bevat de structuur van de UI Automation-structuur die hierboven wordt weergegeven. Houd er rekening mee dat het menu-item Help is opgenomen om de structuur in een typisch menu naar een submenuhiërarchie beter te illustreren.
Voor de inhoudsweergave ontbreekt menu in de ui-automatiseringsstructuur omdat het geen zinvolle informatie aan de eindgebruiker overbrengt.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor besturingselementen voor menu-items. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Eigenschappen | Weergegeven als | Beschrijving |
|---|---|---|
| AutomationIdProperty | Zie notities. | De waarde van deze eigenschap moet uniek zijn voor alle besturingselementen in een toepassing. |
| BoundingRectangleProperty | Zie notities. | De buitenste rechthoek die het hele besturingselement bevat. |
| ClickablePointProperty | Zie notities. | Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, overschrijft en geeft u een klikbaar punt op. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | Zie notities. | Het besturingselement voor menu-items is opgenomen in de inhoudsweergave van de UI Automation-structuur en is zelf gelabeld met een naam. |
| LabeledByProperty | Null |
Geen label. |
| ControlTypeProperty | Menuitem | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "menu-item" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype MenuItem. |
| IsContentElementProperty | Waar | Het besturingselement voor menu-items wordt nooit opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Het menu-itembesturingselement moet altijd worden opgenomen in de besturingsweergave van de UI Automation-structuur. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door besturingselementen voor menu-items. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Eigenschap Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IExpandCollapseProvider | Hangt | Als het besturingselement kan worden uitgevouwen of samengevouwen, implementeert u IExpandCollapseProvider. |
| IInvokeProvider | Hangt | Als het besturingselement één actie of opdracht uitvoert, implementeert u IInvokeProvider. |
| IToggleProvider | Hangt | Als het besturingselement een optie vertegenwoordigt die kan worden ingeschakeld of uitgeschakeld, implementeert u IToggleProvider. |
| ISelectionItemProvider | Hangt | Als het besturingselement wordt gebruikt om te selecteren in een lijst met opties tussen menu-items, implementeert u ISelectionItemProvider. |
Ui Automation-gebeurtenissen voor menu-item
De volgende tabel bevat de Microsoft UI Automation-gebeurtenissen die zijn gekoppeld aan het besturingselement voor menu-items.
| Gebeurtenis | Ondersteuning | Uitleg |
|---|---|---|
| InvokedEvent | Hangt | Moet worden gegenereerd als het besturingselement ondersteuning biedt voor het aanroepen van een besturingspatroon. |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Moet worden verhoogd als het besturingselement een wisselknoppatroon ondersteunt. |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Moet worden verhoogd als het besturingselement Het besturingselement Samenvouwen ondersteunt. |
| ElementSelectedEvent | Hangt | Geen. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor menu-items. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| InvokedEvent | Hangt | Geen |
| ElementAddedToSelectionEvent | Hangt | Geen |
| ElementRemovedFromSelectionEvent | Hangt | Geen |
| ElementSelectedEvent | Hangt | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
Verouderde problemen
Wisselpatroon wordt alleen ondersteund wanneer de Win32-menuopdracht is ingeschakeld en programmatisch kan worden bepaald dat nodig is om wisselpatroon te ondersteunen. Omdat het Win32-menu-item niet zichtbaar is of deze de mogelijkheid heeft om te worden gecontroleerd, wordt Het aanroepen van patroon ondersteund wanneer het menu-item niet is ingeschakeld. Er wordt een uitzondering gemaakt om altijd ondersteuning te bieden voor het aanroepen van patroon, zelfs voor menu-items die alleen wisselknoppatroon moeten ondersteunen. Dit is zodat clients niet meer in de war raken dat een element dat ondersteuning biedt voor het aanroepen van patroon (wanneer menu-item is uitgeschakeld) het patroon niet meer ondersteunt zodra het wordt gecontroleerd.