Delen via


Type treeItem-besturingselement

Dit onderwerp bevat informatie over microsoft UI Automation-ondersteuning voor het TreeItem type besturingselement.

Het besturingselementtype TreeItem vertegenwoordigt een knooppunt in een structuurcontainer. Elk knooppunt kan andere knooppunten bevatten, onderliggende knooppunten genaamd. Bovenliggende knooppunten of knooppunten die onderliggende knooppunten bevatten, kunnen worden weergegeven als uitgevouwen of samengevouwen.

In de volgende secties worden de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor de TreeItem besturingselementtype gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor structuuritems, 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 besturingselementen voor structuuritems en wordt beschreven wat in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Besturingselementweergave Inhoudsweergave
  • TreeItem
    • Selectievakje (0 of 1)
    • Afbeelding (0 of 1)
    • Knop (0 of 1)
    • TreeItem (0 of meer)
  • TreeItem
    • TreeItem (0 of meer)

 

Besturingselementen voor structuuritems kunnen nul of meer onderliggende structuuritems bevatten in de inhoudsweergave van de UI Automation-structuur. Als het structuuritembesturingselement functionaliteit heeft die verder gaat dan wat wordt weergegeven in de onderstaande besturingspatronen, moet het besturingselement zijn gebaseerd op het DataItem- besturingselementtype.

Samengevouwen structuuritems worden pas weergegeven in de besturingselementweergave of inhoudsweergave als ze worden uitgevouwen en zichtbaar zijn (of kunnen naar de weergave worden geschoven).

De besturingselementweergave kan aanvullende informatie bevatten voor een besturingselement, inclusief een bijbehorende afbeelding of een knop. Een item in een overzichtsweergave kan bijvoorbeeld een afbeelding bevatten, evenals een knop om het overzicht uit te vouwen of samen te vouwen. Deze detailobjecten worden niet weergegeven in de inhoudsweergave omdat de informatie al wordt weergegeven door het bovenliggende structuuritem.

Structuuritems die van het scherm zijn geschoven, worden weergegeven in zowel de besturings- als inhoudsweergaven van de UI Automation-structuur en moeten de eigenschap IUIAutomationElement::CurrentIsOffscreen (of CachedIsOffscreen) hebben ingesteld op TRUE.

Relevante eigenschappen

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

Ui Automation-eigenschap Waarde Notities
UIA_AutomationIdPropertyId Zie notities. De waarde van deze eigenschap moet uniek zijn voor alle peerelementen in de onbewerkte weergave van de UI Automation-structuur.
UIA_BoundingRectanglePropertyId Zie notities. De buitenste rechthoek die het hele besturingselement bevat.
UIA_ClickablePointPropertyId Zie notities. Deze eigenschap moet een locatie retourneren die ervoor zorgt dat het structuuritem de selectiestatus wijzigt of gericht wordt.
UIA_ControlTypePropertyId TreeItem- Deze waarde is hetzelfde voor alle UI-frameworks.
UIA_IsContentElementPropertyId TRUE- Het structuuritembesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
UIA_IsControlElementPropertyId TRUE- Het structuuritembesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur.
UIA_IsKeyboardFocusablePropertyId Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
UIA_IsOffscreenPropertyId Zie notities. Met deze eigenschap wordt aangegeven of een besturingselement voor een structuuritem van het scherm wordt geschoven.
UIA_ItemStatusPropertyId Zie notities. Als het besturingselement de status bevat die dynamisch wordt bijgewerkt, moet deze eigenschap worden ondersteund, zodat een ondersteunende technologie updates kan ontvangen wanneer de status van het element verandert.
UIA_ItemTypePropertyId Zie notities. Als het besturingselement voor structuuritems een visueel pictogram gebruikt om aan te geven dat een bepaald type item is, moet deze eigenschap worden ondersteund en moet het itemtype worden aangegeven.
UIA_LabeledByPropertyId NULL- Besturingselementen voor structuuritems zijn zelflabeling.
UIA_LocalizedControlTypePropertyId Zie notities. Gelokaliseerde tekenreeks die overeenkomt met het type TreeItem-besturingselement. De standaardwaarde is 'structuuritem' voor en-US of Engels (Verenigde Staten).
UIA_NamePropertyId Zie notities. Met deze eigenschap wordt de tekst weergegeven voor elk besturingselement voor structuuritems.

 

Vereiste besturingspatronen

De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door alle besturingselementen voor structuuritems. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Besturingselementpatroon/patrooneigenschap Ondersteuning/waarde Notities
IExpandCollapseProvider Vereist Alle structuuritems moeten het ExpandCollapse--besturingspatroon ondersteunen, omdat alle items kunnen worden uitgevouwen of samengevouwen.
ExpandCollapseState- Uitgevouwen, samengevouwen of Leaf-knooppunt Structuuritems zijn bladknooppunten wanneer ze niet worden uitgevouwen of samengevouwen.
IInvokeProvider Hangt Implementeer het besturingspatroon aanroepen als het structuuritem een opdracht kan uitvoeren.
IScrollItemProvider Hangt Implementeer het patroon ScrollItem als de structuurcontainer het scroll--besturingspatroon ondersteunt.
ISelectionItemProvider Hangt Implementeer het SelectionItem-besturingspatroon als het mogelijk is om een actieve selectie te hebben die wordt behouden wanneer de gebruiker terugkeert naar de structuurcontainer.
SelectionContainer- Vereist Met deze eigenschap wordt dezelfde container weergegeven voor alle items in de container.

 

Vereiste gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die besturingselementen voor structuuritems 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_ExpandCollapseExpandCollapseStatePropertyId gebeurtenis die door eigenschap is gewijzigd.
UIA_Invoke_InvokedEventId Als het besturingselement het patroon Aanroepen ondersteunt, moet het deze gebeurtenis ondersteunen.
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_ItemStatusPropertyId gebeurtenis die door eigenschap is gewijzigd. Als het besturingselement de eigenschap ItemStatus ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_MultipleViewCurrentViewPropertyId gebeurtenis die door eigenschap is gewijzigd. Als het besturingselement het MultipleView--besturingspatroon ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_NamePropertyId gebeurtenis gewijzigd door eigenschap.
UIA_SelectionItem_ElementAddedToSelectionEventId Als het besturingselement het patroon SelectionItem ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Als het besturingselement het patroon SelectionItem ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_SelectionItem_ElementSelectedEventId Als het besturingselement het patroon SelectionItem ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId gebeurtenis die door eigenschap is gewijzigd. Als het besturingselement het wisselpatroon besturingselement ondersteunt, moet het deze gebeurtenis ondersteunen.
UIA_ValueValuePropertyId gebeurtenis die door eigenschap is gewijzigd. Als het besturingselement het patroon Waarde ondersteunt, moet het deze gebeurtenis ondersteunen.

 

Opmerkingen

Als een structuuritem andere subelementen heeft dan onderliggende overzichtsknooppunten, moet de provider de informatie van het onderliggende object zorgvuldig en duidelijk verwerken. In UI Automation wordt de structuur verwerkt door de structuur zelf. Door een of meer onderliggende onderliggende knooppunten zonder overzicht te hebben, worden de verschillen tussen de onderliggende en werkelijke onderliggende overzichtsknooppunten ernstig dubbelzinnig.

conceptuele

Overzicht van Ui Automation-besturingstypen

Overzicht van UI Automation-