Delen via

Ui Automation-ondersteuning voor het type DataItem-besturingselement

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 microsoft UI Automation-ondersteuning voor het type DataItem-besturingselement. 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.

Een vermelding in een lijst met contactpersonen is een voorbeeld van een besturingselement voor gegevensitems. Een besturingselement voor gegevensitems bevat informatie die van belang is voor een eindgebruiker. Het is ingewikkelder dan het eenvoudige lijstitem omdat het uitgebreidere informatie bevat.

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

Ui Automation-structuur - Besturingsweergave Ui Automation-structuur - Inhoudsweergave
DataItem

- Varieert (0 of meer; kan in een hiërarchie worden gestructureerd)		 DataItem

- Varieert (0 of meer; kan in een hiërarchie worden gestructureerd)

Een gegevensitemelement in een gegevensraster kan verschillende objecten hosten, waaronder een andere laag gegevensitems, of specifieke rasterelementen, zoals tekst, afbeeldingen of besturingselementen voor bewerken. Als het gegevensitemelement een specifieke objectrol heeft, moet het element worden weergegeven als een specifiek besturingselementtype; Bijvoorbeeld een besturingselementtype ListItem voor een selecteerbaar gegevensitem in het raster.

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen waarvan de waarde of definitie met name relevant is voor besturingselementen voor gegevensitems. Voor meer informatie over UI Automation-eigenschappen, zie UI Automation-eigenschappen voor cliënten.

Vastgoed 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. Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, moet u dit overschrijven en een klikbaar punt bieden.
ControlTypeProperty DataItem Deze waarde is hetzelfde voor alle UI-frameworks.
IsContentElementProperty Klopt Het besturingselement voor gegevensitems moet altijd inhoud zijn.
IsControlElementProperty Klopt Het besturingselement voor gegevensitems moet altijd een besturingselement zijn.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
ItemStatusProperty 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.
ItemTypeProperty Zie notities. Dit is de tekenreekswaarde die de eindgebruiker het onderliggende object aangeeft dat het item voorstelt. Voorbeelden zijn 'Mediabestand' of 'Contactpersoon'.
LabeledByProperty Null Besturingselementen voor gegevensitems hebben geen statisch tekstlabel.
LocalizedControlTypeProperty "gegevensitem" Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype DataItem.
NameProperty Zie notities. Het controle-element voor gegevensitems bevat altijd een primair tekstelement dat betrekking heeft op wat de gebruiker als de meest semantische identificatie voor het item zou beschouwen.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de besturingspatronen van Microsoft UI Automation die moeten worden ondersteund door alle besturingselementen voor gegevensitems. Zie Overzicht van ui-automatiseringspatronenvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IExpandCollapseProvider Dat hangt ervan af. Als het gegevensitem kan worden uitgevouwen of samengevouwen om informatie weer te geven en te verbergen, moet het patroon Uitvouwen/Samenvouwen worden ondersteund.
IGridItemProvider Dat hangt ervan af. Gegevensitems ondersteunen het rasteritempatroon wanneer een verzameling gegevensitems beschikbaar is in een container die ruimtelijk kan worden genavigeerd van item tot item.
IScrollItemProvider Dat hangt ervan af. Alle gegevensitems ondersteunen de mogelijkheid om in beeld te schuiven met het patroon Scroll-item wanneer de gegevenscontainer meer items bevat dan op het scherm past.
ISelectionItemProvider Ja Alle gegevensitems moeten het patroon Selectie-item ondersteunen om aan te geven wanneer het item is geselecteerd.
ITableItemProvider Dat hangt ervan af. Als het gegevensitem zich in een gegevensraster-besturingselementtype bevindt, wordt dit patroon ondersteund.
IToggleProvider Dat hangt ervan af. Als het gegevensitem een status bevat die kan worden doorlopen.
IValueProvider Dat hangt ervan af. Als de primaire tekst van het gegevensitem kan worden bewerkt, moet het waardepatroon worden ondersteund.

Werken met gegevensitems in grote lijsten

Grote lijsten zijn vaak gegevens die worden gevirtualiseerd binnen UI-frameworks om u te helpen bij de prestaties. Daarom kan een UI Automation-client de UI Automation-queryfunctie niet gebruiken om de inhoud van de volledige structuur op dezelfde manier te scrapen als in andere itemcontainers. Een client moet het item in beeld schuiven (of het besturingselement uitvouwen om alle waardevolle opties weer te geven) voordat de volledige set gegevens uit het gegevensitem wordt geopend.

Wanneer u SetFocus aanroept op het UI Automation-element voor het gegevensitem, zal het Microsoft Windows Verkenner-geval succesvol worden geretourneerd en wordt de focus ingesteld op de Bewerken-optie binnen de substructuur van het gegevensitem.

Vereiste UI Automation-gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor gegevensitems. 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
NameProperty eigenschapswijziging-evenement. Verplicht Geen
StructureChangedEvent Verplicht Geen
InvokedEvent Dat hangt ervan af. Geen
ExpandCollapseStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
ElementAddedToSelectionEvent Verplicht Geen
ElementRemovedFromSelectionEvent Verplicht Geen
ElementSelectedEvent Verplicht Geen
ToggleStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
ValueProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen

Voorbeeld van gegevensitem-besturingselementtype

In de volgende afbeelding ziet u een DataItem-besturingselement type in een Lijstweergave-besturingselement met ondersteuning voor uitgebreide kolom-informatie.

Afbeelding van een lijstweergavebesturingselement met twee gegevens

De besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op het besturingselement voor gegevensitems, wordt hieronder weergegeven. De besturingspatronen voor elk automatiseringselement worden tussen haakjes weergegeven. De groep Contoso maakt ook deel uit van het datagrid in de hostbesturing.

Ui Automation-structuur - Besturingsweergave Ui Automation-structuur - Inhoudsweergave
- Groep 'Contoso' (tabel, raster)
- DataItem 'Accounts Receivable.doc' (TableItem, GridItem, SelectionItem, Invoke)
- Afbeelding 'Accounts Receivable.doc'
- Bewerken "Naam" (TableItem, GridItem, Waarde "Accounts Receivable.doc")
- Edit "Date modified" (TableItem, GridItem, Value "25/08/2006 3:29 PM")
- 'Grootte' bewerken (GridItem, TableItem, Waarde "11,0 KB)
- DataItem 'Accounts Payable.doc' (TableItem, GridItem, SelectionItem, Invoke)
- ...		 - Groep 'Contoso' (tabel, raster)
- DataItem 'Accounts Receivable.doc' (TableItem, GridItem, SelectionItem, Invoke)
- Afbeelding 'Accounts Receivable.doc'
- Bewerken "Naam" (TableItem, GridItem, Waarde "Accounts Receivable.doc")
- Edit "Date modified" (TableItem, GridItem, Value "25/08/2006 3:29 PM")
- 'Grootte' bewerken (GridItem, TableItem, Waarde "11,0 KB)
- DataItem 'Accounts Payable.doc' (TableItem, GridItem, SelectionItem, Invoke)
- …

Als een raster een lijst met selecteerbare items vertegenwoordigt, kunnen de bijbehorende UI-elementen worden weergegeven met het besturingselement ListItem in plaats van het besturingselementtype DataItem. In het voorgaande voorbeeld kunnen de DataItem-elementen ('Accounts Receivable.doc' en 'Accounts Payable.doc') onder Groep ('Contoso') worden verbeterd door ze beschikbaar te maken als ListItem-besturingstypen, omdat dat type al het selectionItem-besturingselementpatroon ondersteunt.

Zie ook

  • Last updated on