Stöd för användargränssnittsautomatisering för tabellkontrolltypen
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller information om stöd för UI Automation för tabellkontrolltypen. I UI Automation är en kontrolltyp en uppsättning villkor som en kontroll måste uppfylla för att kunna använda egenskapen ControlTypeProperty . Villkoren innehåller specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Tabellkontroller innehåller rader och kolumner med text, och valfritt radrubriker och kolumnrubriker.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för tabellkontrolltypen. Kraven för UI Automation gäller för alla tabellkontroller, oavsett om windows presentationsstiftelsen (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
I följande tabell visas kontrollvyn och innehållsvyn för 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 Översikt över UI Automation Tree.
| Kontrollvy | Innehållsvy |
|---|---|
| Register - Rubrik (0 eller 1) - Text (0 eller 1) – Olika kontroller (0 eller fler) |
Register - Text (0 eller mer) – Olika kontroller (0 eller fler) |
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 TablePattern.
Nödvändiga egenskaper för UI Automation
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 UI Automation Properties for Clients (Egenskaper för gränssnittsautomatisering för klienter).
| UI Automation-egenskap | Värde | Kommentar |
|---|---|---|
| AutomationIdProperty | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
| BoundingRectangleProperty | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| ClickablePointProperty | Se anteckningar. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning åsidosätter du och anger en klickbar punkt. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Tabellkontrollen hämtar vanligtvis sitt namn från en statisk textetikett. Om det inte finns någon statisk textetikett måste du tilldela en namnegenskap som alltid måste vara tillgänglig för att förklara syftet med tabellen. |
| LabeledByProperty | Se anteckningar. | Om det finns en statisk textetikett bör den här egenskapen exponera en referens till automationselementet i kontrollen. |
| ControlTypeProperty | Register | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "table" | Lokaliserad sträng som motsvarar tabellkontrolltypen. |
| HelpTextProperty | Se anteckningar. | Mer information om syftet med tabellen bör exponeras via den här egenskapen om den inte förklaras tillräckligt genom åtkomst till NameProperty. |
| IsContentElementProperty | Sant | Tabellkontrollen måste alltid vara innehåll. |
| IsControlElementProperty | Sant | Tabellkontrollen måste alltid vara en kontroll. |
Nödvändiga UI Automation-kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av tabellkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IGridProvider | Ja | Tabellkontrollen stöder alltid det här kontrollmönstret eftersom de objekt som den innehåller har data som visas i ett rutnät. |
| IGridItemProvider | Ja (krävs med underordnade objekt) | De inre objekten i en tabell bör ha stöd för kontrollmönstren GridItem och TableItem. 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. |
| ITableProvider | Ja | Tabellkontrollen har alltid möjlighet att ha rubriker associerade med innehållet. |
| ITableItemProvider | Ja (krävs med underordnade objekt) | De inre objekten i en tabell bör ha stöd för kontrollmönstren GridItem och TableItem. 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 UI Automation-händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla tabellkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |