Tabellkontrolltyp
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Table.
Tabellkontroller innehåller rader och kolumner med text och, om du vill, radrubriker och kolumnrubriker.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Tabell kontrolltyp. Kraven för UI Automation gäller för alla tabellkontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.
Det här avsnittet innehåller följande avsnitt.
- typisk trädstruktur
- relevanta egenskaper
- nödvändiga kontrollmönster
- nödvändiga händelser
- Relaterade ämnen
Typisk trädstruktur
I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som gäller för tabellkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.
| Kontrollvy | Innehållsvy |
|---|---|
|
|
Om en tabellkontroll har rad- eller kolumnrubriker måste de exponeras i kontrollvyn för UI Automation-trädet. Innehållsvyn behöver inte exponera den här informationen eftersom den kan nås med hjälp av IUIAutomationTablePattern.
Relevanta egenskaper
I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för tabellkontroller. Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.
| UI Automation-egenskap | Värde | Anteckningar |
|---|---|---|
| UIA_AutomationIdPropertyId | Se anteckningar. | Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet. |
| UIA_BoundingRectanglePropertyId | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| UIA_ClickablePointPropertyId | Se anteckningar. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och elementet utför specialiserad träfftestning åsidosätter och ger en klickbar punkt. |
| UIA_ControlTypePropertyId | tabell | |
| UIA_DescribedByPropertyId | Se anteckningar. | Om tabellen kommenteras av ett annat gränssnittselement (till exempel ett textelement som innehåller beskrivningen för tabellen) bör egenskapen DescribedBy exponera en referens till automationselementet i textkontrollen. |
| UIA_HelpTextPropertyId | Se anteckningar. | Mer information om syftet med tabellen bör exponeras via den här egenskapen om den inte förklaras tillräckligt av egenskapen UIA_NamePropertyId. |
| UIA_IsContentElementPropertyId | SANN | Tabellkontrollen måste alltid visas i innehållsvyn i UI Automation-trädet. |
| UIA_IsControlElementPropertyId | SANN | Tabellkontrollen måste alltid visas i kontrollvyn i UI Automation-trädet. |
| UIA_IsKeyboardFocusablePropertyId | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| UIA_LabeledByPropertyId | Se anteckningar. | Om det finns en statisk textetikett bör den här egenskapen exponera en referens till automationselementet i kontrollen. |
| UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar tabell kontrolltyp. Standardvärdet är "table" för en-US eller engelska (USA). |
| UIA_NamePropertyId | Se anteckningar. | Tabellkontrollen hämtar vanligtvis värdet för namnet från en statisk textetikett. Om det inte finns en statisk textetikett måste elementet tilldela en namnegenskap som alltid måste vara tillgänglig för att förklara syftet med tabellen. |
Nödvändiga kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av alla tabellkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
| Kontrollmönster | Stöd | Anteckningar |
|---|---|---|
| IGridProvider | Krävs | Eftersom tabellkontrollen innehåller objekt som visas i ett rutnät har den alltid stöd för Grid kontrollmönster. |
| IGridItemProvider | Krävs med underordnade objekt | De inre objekten i en tabell bör ha stöd för både GridItem och TableItem kontrollmönster. Själva tabellen behöver inte ha stöd för kontrollmönstret GridItem eller TableItem om inte tabellen är en del av en annan tabell. |
| ITableProvider | Krävs | Tabellkontrollen kan alltid ha rubriker associerade med innehållet. |
| ITableItemProvider | Krävs med underordnade objekt | De inre objekten i en tabell bör ha stöd för både GridItem och TableItem kontrollmönster. Själva tabellen behöver inte ha stöd för kontrollmönstren GridItem eller TableItem om tabellen inte ingår i en annan tabell. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som tabellkontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.
| UI Automation-händelse | Anteckningar |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen. | |
| UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen. |
| UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen. |
| UIA_StructureChangedEventId |
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation