Rutnätskontrollmönster
Beskriver riktlinjer och konventioner för att implementera IGridProvider, inklusive information om egenskaper och metoder. Kontrollmönstret Grid 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 Kontrolltyper och Deras kontrollmönster som stöds.
Det här avsnittet innehåller följande avsnitt.
- riktlinjer och konventioner för implementering
- Medlemmar som krävs för IGridProvider
- Relaterade ämnen
Riktlinjer och konventioner för implementering
Observera följande riktlinjer och konventioner när du implementerar Grid kontrollmönster:
Rutnätskoordinater är nollbaserade med den övre vänstra (eller övre högra cellen beroende på nationella inställningar) med koordinater (0,0).
Om en cell är tom måste ett Microsoft UI Automation-element fortfarande returneras för att stödja egenskapen IGridItemProvider::ContainingGrid för cellen. Detta är möjligt när layouten för underordnade element i rutnätet liknar en ojämn matris (se exemplet nedan).
Ett rutnät med ett enda 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, beroende på providerimplementeringen, kan läsas in i UI Automation-trädet och återspeglas därför i egenskaperna IGridProvider::RowCount och ColumnCount. Om de dolda raderna och kolumnerna ännu inte har lästs in bör de inte räknas.
IGridProvider inte aktiverar aktiv manipulering av ett rutnät. ITransformProvider måste implementeras för att aktivera den här funktionen.
Använd en IUIAutomationStructureChangedEventHandler 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 IUIAutomationFocusChangedEventHandler- för att spåra bläddring genom objekten eller cellerna i ett rutnät.
Obligatoriska medlemmar för IGridProvider
Följande egenskaper och metoder krävs för att implementera gränssnittet IGridProvider.
| Obligatoriska medlemmar | Medlemstyp | Anteckningar |
|---|---|---|
| RowCount | Egenskap | Ingen |
| ColumnCount | Egenskap | Ingen |
| GetItem | Metod | Ingen |
Det här kontrollmönstret har inga associerade händelser.
Relaterade ämnen
-
översikt över UI Automation-kontrollmönster