Dela via

Implementering av UI Automation Grid-kontrollmönstret

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 IGridProvider, inklusive information om egenskaper, metoder och händelser. Länkar till ytterligare referenser visas i slutet av översikten.

Kontrollmönstret GridPattern används för att stödja kontroller som fungerar som containrar för en samling underordnade element. Underordnade element måste implementera IGridItemProvider och ordnas i ett tvådimensionellt logiskt koordinatsystem som kan passeras av rad och kolumn. 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 rutnätskontrollmönstret:

  • Rutnätskoordinater är nollbaserade, och den övre vänstra (eller övre högra cellen beroende på lokala inställningar) har koordinaterna (0, 0).

  • Om en cell är tom måste ett UI Automation-element fortfarande returneras för att stödja egenskapen för cellen ContainingGrid . Detta är möjligt när layouten för underordnade element i rutnätet liknar en ojämn matris (se exemplet nedan).

Windows Explorer-vyn som visar ojämn layout. Exempel på en rutnätskontroll med tomma koordinater

  • Ett rutnät med ett enskilt objekt krävs fortfarande för att implementera IGridProvider om det logiskt anses vara ett rutnät. Antalet underordnade objekt i rutnätet är oväsentligt.

  • Dolda rader och kolumner kan, beroende på providerimplementeringen, läsas in i UI Automation-trädet och således återspeglas i RowCount och ColumnCount-egenskapen. Om de dolda raderna och kolumnerna ännu inte har lästs in bör de inte räknas.

  • IGridProvider aktiverar inte aktiv manipulering av ett rutnät. ITransformProvider måste implementeras för att aktivera den här funktionen.

  • Använd en StructureChangedEventHandler för att lyssna efter strukturella ändringar eller layoutändringar i rutnätet, till exempel celler som har lagts till, tagits bort eller sammanfogats.

  • Använd en AutomationFocusChangedEventHandler för att spåra bläddering genom objekten eller cellerna i ett rutnät.

Obligatoriska medlemmar för IGridProvider

Följande egenskaper och metoder krävs för att implementera IGridProvider-gränssnittet.

Obligatoriska medlemmar Typ Noteringar
RowCount Fastighet Ingen
ColumnCount Fastighet Ingen
GetItem Metod Ingen

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

Undantag

Leverantörer måste utlösa följande undantag.

Undantagstyp Tillstånd
ArgumentOutOfRangeException GetItem

– Om den begärda radkoordinaten RowCount är större än eller om kolumnkoordinaten är större än ColumnCount.
ArgumentOutOfRangeException GetItem

– Om någon av de begärda rad- eller kolumnkoordinaterna är mindre än noll.

Se även

  • Last updated on