Implementera gränssnittsautomationsmönster för tabellkontroll

Anmärkning

Den här dokumentationen är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i System.Windows.Automation namnrymd. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.

Det här avsnittet innehåller riktlinjer och konventioner för att implementera ITableProvider, inklusive information om egenskaper, metoder och händelser. Länkar till ytterligare referenser visas i slutet av översikten.

Kontrollmönstret TablePattern används för att stödja kontroller som fungerar som containrar för en samling underordnade element. Underordnade element måste implementera ITableItemProvider och ordnas i ett tvådimensionellt logiskt koordinatsystem som kan passeras av rad och kolumn. Det här kontrollmönstret motsvarar IGridProvider, med skillnaden att alla kontroller som implementerar ITableProvider också måste exponera en kolumn- och/eller radrubrikrelation för varje underordnat element. Exempel på kontroller som implementerar det här kontrollmönstret finns i Kontrollmönstermappning för UI Automation-klienter.

Riktlinjer och konventioner för implementering

Observera följande riktlinjer och konventioner när du implementerar tabellkontrollmönstret:

  • Åtkomst till innehållet i enskilda celler sker via ett tvådimensionellt logiskt koordinatsystem eller matris som tillhandahålls av den nödvändiga samtidiga implementeringen av IGridProvider.

  • En kolumn eller radrubrik kan finnas i ett tabellobjekt eller vara ett separat rubrikobjekt som är associerat med ett tabellobjekt.

  • Kolumn- och radrubriker kan innehålla både en primär rubrik och eventuella stödhuvuden.

Anmärkning

Det här konceptet blir tydligt i ett Microsoft Excel-kalkylblad där en användare har definierat kolumnen "Förnamn". Den här kolumnen har nu två rubriker – rubriken "Förnamn" som definierats av användaren och den alfanumeriska beteckningen för den kolumn som tilldelats av programmet.

Tabell med komplexa rubrikobjekt. Exempel på en tabell med komplexa kolumnrubriker

Tabell med tvetydig RowOrColumnMajor-egenskap. Exempel på en tabell med tvetydig RowOrColumnMajor-egenskap

Obligatoriska medlemmar för ITableProvider

Följande egenskaper och metoder krävs för gränssnittet ITableProvider.

Obligatoriska medlemmar Medlemstyp Noteringar
RowOrColumnMajor Fastighet Ingen
GetColumnHeaders Metod Ingen
GetRowHeaders Metod Ingen

Det här kontrollmönstret har inga associerade händelser.

Undantag

Det här kontrollmönstret har inga associerade undantag.

Se även