Delen via


UI Automation-ondersteuning voor het menucontroltype

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 type menubesturing. In dit document wordt de structuur van de Microsoft UI Automation-boom van het besturingselement beschreven en worden de eigenschappen en besturingspatronen voor specifieke scenario's voor besturingselementen geboden.

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 menuknoppen (zoals Bestand, Bewerkenen Venster), en elke menuknop 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 om een specifieke actie uit te voeren wanneer erop wordt geklikt.

In de volgende secties worden de vereiste structuur van de UI Automation-boom, eigenschappen, besturingspatronen en gebeurtenissen voor het menubesturingstype gedefinieerd. 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 menubesturingselementen 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
Menulijst

- Menu-item (1 ofwel veel)
Niet van toepassing (tenzij de menubesturing een contextmenu is dat een ouderobject is dat geen menu-item is)

- Menu-item (1 ofwel veel)

Menubesturingselementen worden altijd weergegeven in de besturingsweergave en de inhoudsweergave van de UI Automation-structuur. Menubesturingstypen moeten worden weergegeven onder het besturingselement waarnaar de informatie verwijst. UI Automation-clients moeten luisteren voor MenuOpenedEvent om ervoor te zorgen dat ze consistent informatie verkrijgen die wordt overgebracht door menu-elementen. Contextmenubesturingselementen zijn een speciaal geval. Ze verschijnen als kinderen van het bureaublad.

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor het type menubesturing. Zie UI Automation-eigenschappen voor cliƫnten voor meer informatie over UI Automation-eigenschappen.

UI Automation-eigenschap Waarde Opmerkingen
NameProperty Niet ondersteund Voor het menubesturingselement hoeft geen eigenschap Name te worden ingesteld.
LabeledByProperty Null Er wordt geen label verwacht met een typisch menu-besturingselement.
ControlTypeProperty Menulijst Deze waarde is hetzelfde voor alle UI-frameworks.
IsContentElementProperty Onwaar Het menubesturingselement is niet opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt Het menubesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur.

Vereiste patronen voor ui-automatiseringsbeheer

Er zijn geen besturingspatronen vereist voor het type Menu-besturingselement.

Vereiste UI Automation-gebeurtenissen

Menubesturingselementen moeten activeren MenuOpenedEvent wanneer ze op het scherm verschijnen. De MenuOpenedEvent zal de tekst van het besturingselement bevatten. De MenuClosedEvent knop moet worden verhoogd wanneer een menu van het scherm verdwijnt.

De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle menubesturingselementen. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning/waarde Opmerkingen
MenuOpenedEvent Verplicht Geen
MenuClosedEvent Verplicht Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Zie ook