Delen via

Type menubesturing

Dit onderwerp bevat informatie over microsoft UI Automation-ondersteuning voor het menu type 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 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, eigenschappen, besturingspatronen en gebeurtenissen voor het Menu besturingselementtype gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle menubesturingselementen waarbij het UI-framework/platform UI Automation-ondersteuning integreert voor besturingstypen en besturingspatronen.

Dit onderwerp bevat de volgende secties.

Typische boomstructuur

In de volgende tabel ziet u een typische besturings- en inhoudsweergave van de UI Automation-structuur die betrekking heeft op menubesturingselementen en beschrijft wat er in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Besturingselementweergave Inhoudsweergave
  • Menu
    • MenuItem (1 of veel)
    • Andere besturingselementen (0 of veel)
  • Menu
    • MenuItem (1 of veel)
    • Andere besturingselementen (0 of veel)

 

Menubesturingselementen worden altijd weergegeven in de besturingsweergave en de inhoudsweergave van de UI Automation-structuur. Menubesturingselementen moeten worden weergegeven onder het besturingselement waarnaar de informatie verwijst. UI Automation-clients kunnen luisteren naar UIA_MenuOpenedEventId om ervoor te zorgen dat ze consistent informatie verkrijgen die wordt overgebracht door menubesturingselementen. Contextmenubesturingselementen zijn een speciaal geval. Ze kunnen worden weergegeven als onderliggende elementen van het bureaublad of een toepassingsvenster op het hoogste niveau.

Een menubesturingselement kan andere besturingselementen bevatten, zoals besturingselementen bewerken en keuzelijsten met invoervak, binnen de structuur. Deze aanvullende besturingselementen komen overeen met de 'andere besturingselementen' die worden vermeld in de vorige tabel in de besturingselement- en inhoudsweergaven.

Relevante eigenschappen

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor het menu besturingselementtype. Zie Eigenschappen ophalen uit UI Automation Elementsvoor meer informatie over eigenschappen van UI Automation Automation.

Ui Automation-eigenschap Waarde Notities
UIA_ControlTypePropertyId menu
UIA_IsContentElementPropertyId WAAR Het menubesturingselement is altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
UIA_IsControlElementPropertyId WAAR Het menubesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur.
UIA_LabeledByPropertyId NUL Er wordt geen label verwacht met een typisch menu-besturingselement.
UIA_NamePropertyId Zie notities. Voor het menubesturingselement is geen eigenschap Naam ingesteld, of kan deze dezelfde naam hebben als het bijbehorende besturingselement, zoals een menu-item waarmee het submenu is geopend.

 

Vereiste besturingspatronen

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

Vereiste gebeurtenissen

Menubesturingselementen moeten de UIA_MenuOpenedEventId gebeurtenis verhogen wanneer deze op het scherm worden weergegeven. De gebeurtenis UIA_MenuOpenedEventId bevat de tekst van het besturingselement. De gebeurtenis UIA_MenuClosedEventId moet worden gegenereerd wanneer een menu van het scherm verdwijnt.

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

Ui Automation-gebeurtenis Notities
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId gebeurtenis die door eigenschappen is gewijzigd.
UIA_IsEnabledPropertyId gebeurtenis die door eigenschap is gewijzigd. Als het besturingselement de eigenschap IsEnabled ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_IsOffscreenPropertyId gebeurtenis die door eigenschap is gewijzigd. Als het besturingselement de eigenschap IsOffscreen ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

conceptuele

Overzicht van Ui Automation-besturingstypen

Overzicht van UI Automation-