Delen via

UI Automation-ondersteuning voor het TreeItem-besturingselementtype

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 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 boomitembesturingselementen, of het nu Windows Presentation Foundation (WPF), Win32 of Windows Forms betreft.

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 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.

Controleweergave Inhoudsweergave
Boomonderdeel

- Selectievakje (0 of 1)
- Afbeelding (0 of 1)
- Knop (0 of 1)
- TreeItem (0 of meer)		 Boomonderdeel

- 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 UI Automation-eigenschappen voor cliënten voor meer informatie over UI Automation-eigenschappen.

UI Automation-eigenschap Waarde 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 zijn selectiestatus verandert of in focus komt.
ControlTypeProperty Boomonderdeel Deze waarde is hetzelfde voor alle UI-frameworks.
IsContentElementProperty Klopt Het lijstbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt 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 boomitem-besturingselement 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 Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Besturingselementpatroon/patrooneigenschap Ondersteuning/waarde Opmerkingen
IInvokeProvider Dat hangt ervan af. 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 Dat hangt ervan af. Implementeer dit besturingspatroon als de boomcontainer het Scroll-besturingspatroon ondersteunt.
ISelectionItemProvider Dat hangt ervan af. 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 Dat hangt ervan af. Implementeer dit besturingspatroon als het boomitem 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-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
AutomationFocusChangedEvent Verplicht Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
ItemStatusProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
NameProperty eigenschapswijziging-evenement. Verplicht Geen
StructureChangedEvent Verplicht Geen
ExpandCollapseStateProperty eigenschapswijziging-evenement. Verplicht Geen
InvokedEvent Dat hangt ervan af. Geen
CurrentViewProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
ElementAddedToSelectionEvent Dat hangt ervan af. Geen
ElementRemovedFromSelectionEvent Dat hangt ervan af. Geen
ElementSelectedEvent Dat hangt ervan af. Geen
ToggleStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
ValueProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen

Zie ook

  • Last updated on