Ui Automation-ondersteuning voor het type tabelbesturing
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 type tabelbesturing. 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.
Tabelbesturingselementen bevatten rijen en kolommen met tekst, en eventueel rijkoppen en kolomkoppen.
In de volgende secties worden de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type tabelbesturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle tabelbesturingselementen, 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 tabelbesturingselementen 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 |
|---|---|
| Tabel - Koptekst (0 of 1) - Tekst (0 of 1) - Diverse besturingselementen (0 of meer) |
Tabel - Tekst (0 of meer) - Diverse besturingselementen (0 of meer) |
Als een tabelbesturingselement rij- of kolomkoppen bevat, moeten deze worden weergegeven in de besturingsweergave van de UI Automation-structuur. De inhoudsweergave hoeft deze informatie niet beschikbaar te maken omdat deze kan worden geopend met behulp van TablePattern.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor tabelbesturingselementen. 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. | Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, overschrijft en geeft u een klikbaar punt op. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | Zie notities. | Het tabelbeheer haalt doorgaans de naam op van een statisch tekstlabel. Als er geen statisch tekstlabel is, moet u een naameigenschap toewijzen die altijd beschikbaar moet zijn om het doel van de tabel uit te leggen. |
| LabeledByProperty | Zie notities. | Als er een statisch tekstlabel is, moet deze eigenschap een verwijzing naar het automatiseringselement van het besturingselement weergeven. |
| ControlTypeProperty | Tabel | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "tabel" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Tabel. |
| HelpTextProperty | Zie notities. | Meer informatie over het doel van de tabel moet worden weergegeven via deze eigenschap als deze niet voldoende wordt uitgelegd door toegang te krijgen tot NameProperty. |
| IsContentElementProperty | Waar | Het tabelbeheer moet altijd inhoud zijn. |
| IsControlElementProperty | Waar | Het tabelbeheer moet altijd een besturingselement zijn. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door tabelbesturingselementen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IGridProvider | Ja | Het tabelbeheer ondersteunt dit besturingselement altijd omdat de items die het bevat gegevens bevatten die in een raster worden weergegeven. |
| IGridItemProvider | Ja (vereist met onderliggende objecten) | De binnenste objecten van een tabel moeten zowel de rasteritem- als tabelitem-besturingspatronen ondersteunen. De tabel zelf hoeft geen ondersteuning te bieden voor de rasteritem- of TableItem-besturingspatronen, tenzij de tabel deel uitmaakt van een andere tabel. |
| ITableProvider | Ja | Het tabelbeheer heeft altijd de mogelijkheid om kopteksten aan de inhoud te koppelen. |
| ITableItemProvider | Ja (vereist met onderliggende objecten) | De binnenste objecten van een tabel moeten zowel de rasteritem- als tabelitem-besturingspatronen ondersteunen. De tabel zelf hoeft geen ondersteuning te bieden voor de rasteritem- of TableItem-besturingspatronen, tenzij de tabel deel uitmaakt van een andere tabel. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle tabelbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |