Ui Automation-ondersteuning voor het treeItem-besturingselementtype
Notitie
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 Automation voor de meest recente informatie over UI Automation.
Dit onderwerp bevat informatie over ui Automation-ondersteuning voor het treeItem-besturingstype. In UI Automation is een besturingselementtype een set voorwaarden waaraan een besturingselement moet voldoen om de ControlTypeProperty eigenschap te kunnen gebruiken. De voorwaarden omvatten specifieke richtlijnen voor de structuur van de UI Automation-structuur, waarden voor UI Automation-eigenschappen en besturingspatronen.
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 wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen gedefinieerd voor het type TreeItem-besturingselement. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor structuuritems, ongeacht of Windows Presentation Foundation (WPF), Win32 of Windows Forms.
Vereiste structuur van ui-automatiseringsstructuur
In de volgende tabel ziet u de besturingsweergave en de 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-automatiseringsstructuur voor 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 besturingselementtype Gegevensitem.
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 worden geschoven, worden weergegeven in zowel de besturings- als inhoudsweergaven van de UI Automation-structuur en moeten de IsOffscreenProperty set waar hebben.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor lijstbesturingselementen. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Ui Automation-eigenschap | Weergegeven als | Opmerkingen |
|---|---|---|
| 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. | Deze eigenschap moet een locatie retourneren van het item waardoor het item de selectiestatus wijzigt of gericht wordt. |
| ControlTypeProperty | TreeItem | Deze waarde is hetzelfde voor alle UI-frameworks. |
| IsContentElementProperty | Waar | Het lijstbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Het lijstbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
| IsOffscreenProperty | Zie notities. | Deze eigenschap is ingesteld om aan te geven wanneer een besturingselement voor een boomstructuuritem van het scherm wordt gescrold. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| ItemTypeProperty | Zie notities. | Als het structuuritembesturingselement een visueel pictogram gebruikt om aan te geven dat het een bepaald type object is, moet deze eigenschap worden ondersteund en aangeven wat het object is. |
| LabeledByProperty | Null |
Besturingselementen voor structuuritems zijn zelflabeling. |
| LocalizedControlTypeProperty | "structuuritem" | Gelokaliseerde tekenreeks die overeenkomt met het type TreeItem-besturingselement. |
| NameProperty | Zie notities. | Met deze eigenschap wordt de tekst weergegeven voor elk besturingselement voor structuuritems. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door lijstbesturingselementen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon/patrooneigenschap | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| IInvokeProvider | Hangt | Implementeer dit besturingspatroon als het structuuritem een afzonderlijke, bruikbare opdracht heeft. |
| IExpandCollapseProvider | Ja | Alle structuuritems kunnen worden uitgevouwen of samengevouwen. |
| ExpandCollapseState | Uitgevouwen, samengevouwen of Leaf-knooppunt | Structuuritems zijn bladknooppunten wanneer ze niet worden uitgevouwen of samengevouwen. |
| IScrollItemProvider | Hangt | Implementeer dit besturingspatroon als de structuurcontainer het schuifbesturingselementpatroon ondersteunt. |
| ISelectionItemProvider | Hangt | Implementeer dit besturingspatroon als het mogelijk is om een actieve selectie te hebben die wordt onderhouden wanneer de gebruiker terugkeert naar de structuurcontainer. |
| SelectionContainer | Ja | Met deze eigenschap wordt dezelfde container weergegeven voor alle items in de container. |
| IToggleProvider | Hangt | Implementeer dit besturingspatroon als het structuuritem een gekoppeld selectievakje heeft. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor structuuritems. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| AutomationFocusChangedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ItemStatusProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| NameProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| InvokedEvent | Hangt | Geen |
| CurrentViewProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| ElementAddedToSelectionEvent | Hangt | Geen |
| ElementRemovedFromSelectionEvent | Hangt | Geen |
| ElementSelectedEvent | Hangt | Geen |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Hangt | None |