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 structuurstructuur
- relevante eigenschappen
- Vereiste besturingspatronen
- vereiste gebeurtenissen
- opmerkingen
- Verwante onderwerpen
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 |
|---|---|
|
|
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.
Verwante onderwerpen
-
conceptuele
-
Overzicht van Ui Automation-besturingstypen
-
Overzicht van UI Automation-