Delen via

UI Automation-ondersteuning voor het menu-item-besturingselementtype

Opmerking

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 Automationvoor 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 Nieuwe, openen en sluiten), die kunnen 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 voor UI-automatisering

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.

Controleweergave Inhoudsweergave
MenuItem 'Help'

  • Menu (submenu van menu-item Help)

    • MenuItem 'Help-onderwerpen'
    • MenuItem "Info Kladblok"
 MenuItem 'Help'

- MenuItem "Help-onderwerpen"
- Menu-item "Info 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 UI Automation-eigenschappen voor cliënten voor meer informatie over UI Automation-eigenschappen.

Vastgoed Waarde 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, moet u dit overschrijven en een klikbaar punt bieden.
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 Menu-item Deze waarde is hetzelfde voor alle UI-frameworks.
LocalizedControlTypeProperty menu-item Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype MenuItem.
IsContentElementProperty Klopt Het besturingselement voor menu-items wordt nooit opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt 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 Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Eigenschap van het besturingspatroon Ondersteuning Opmerkingen
IExpandCollapseProvider Dat hangt ervan af. Als het besturingselement kan worden uitgevouwen of samengevouwen, implementeert u IExpandCollapseProvider.
IInvokeProvider Dat hangt ervan af. Als het besturingselement één actie of opdracht uitvoert, implementeert u IInvokeProvider.
IToggleProvider Dat hangt ervan af. Als het besturingselement een optie vertegenwoordigt die kan worden ingeschakeld of uitgeschakeld, implementeert u IToggleProvider.
ISelectionItemProvider Dat hangt ervan af. Als het besturingselement wordt gebruikt om te selecteren in een lijst met opties tussen menu-items, implementeert u ISelectionItemProvider.

UI Automation-gebeurtenissen voor menuonderdeel

De volgende tabel bevat de Microsoft UI Automation-gebeurtenissen die zijn gekoppeld aan het besturingselement voor menu-items.

Gebeurtenis Ondersteuning Uitleg
InvokedEvent Dat hangt ervan af. Moet worden gegenereerd als het besturingselement de Invoke-besturingspatroon ondersteunt.
ToggleStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Moet worden verhoogd als het besturingselement een wisselknoppatroon ondersteunt.
ExpandCollapseStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Moet worden verhoogd als het besturingselement het patroon Uitvouwen/Inklappen ondersteunt.
ElementSelectedEvent Dat hangt ervan af. 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-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning/waarde Opmerkingen
InvokedEvent Dat hangt ervan af. Geen
ElementAddedToSelectionEvent Dat hangt ervan af. Geen
ElementRemovedFromSelectionEvent Dat hangt ervan af. Geen
ElementSelectedEvent Dat hangt ervan af. Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
ExpandCollapseStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
ToggleStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Verouderde problemen

Wisselpatroon wordt alleen ondersteund wanneer het Win32-menu-item is aangevinkt en programmatisch kan worden vastgesteld dat het nodig is om Wisselpatroon te ondersteunen. Omdat het Win32-menu-item niet laat zien of het selecteerbaar is, wordt het oproeppatroon ondersteund wanneer het menu-item niet is aangevinkt. Er zal een uitzondering worden gemaakt om altijd ondersteuning te bieden aan Invoke Pattern, zelfs voor menu-items die alleen Toggle Pattern moeten ondersteunen. Dit is zodat klanten niet in de war raken dat een element dat het aanroeppatroon ondersteunt (wanneer menu-item is uitgeschakeld), het patroon niet meer ondersteunt zodra het ingeschakeld wordt.

Zie ook

  • Last updated on