Pattern di controllo griglia
Vengono descritte le linee guida e le convenzioni per l'implementazione di IGridProvider, incluse informazioni su proprietà e metodi. Il pattern di controllo griglia di viene usato per supportare i controlli che fungono da contenitori per una raccolta di elementi figlio.
Gli elementi figlio di questo elemento devono implementare IGridItemProvider ed essere organizzati in un sistema di coordinate logico bidimensionale che può essere attraversato da riga e colonna. Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.
Questo argomento contiene le sezioni seguenti.
- linee guida e convenzioni di implementazione
- membri obbligatori per IGridProvider
- argomenti correlati
Linee guida e convenzioni di implementazione
Quando si implementa il pattern di controllo Grid, tenere presenti le linee guida e le convenzioni seguenti:
Le coordinate della griglia sono in base zero con la cella superiore sinistra (o superiore destra a seconda delle impostazioni locali) con coordinate (0,0).
Se una cella è vuota, è necessario restituire un elemento di Automazione interfaccia utente Microsoft per supportare la proprietà IGridItemProvider::ContainingGrid per tale cella. Ciò è possibile quando il layout degli elementi figlio nella griglia è simile a una matrice incompleta (vedere l'esempio seguente).
Una griglia con un singolo elemento è comunque necessaria per implementare IGridProvider se viene considerata logicamente una griglia. Il numero di elementi figlio nella griglia è irrilevante.
Le righe e le colonne nascoste, a seconda dell'implementazione del provider, possono essere caricate nell'albero di automazione interfaccia utente e pertanto verranno riflesse nelle proprietà IGridProvider::RowCount e ColumnCount. Se le righe e le colonne nascoste non sono ancora state caricate, non devono essere conteggiate.
IGridProvider non abilita la manipolazione attiva di una griglia; ITransformProvider deve essere implementato per abilitare questa funzionalità.
Usare un IUIAutomationStructureChangedEventHandler per ascoltare le modifiche strutturali o di layout alla griglia, ad esempio le celle aggiunte, rimosse o unite.
Usare un IUIAutomationFocusChangedEventHandler per tenere traccia dell'attraversamento tra gli elementi o le celle di una griglia.
Membri obbligatori per IGridProvider
Per implementare l'interfacciaIGridProvidersono necessari i metodi e le proprietà seguenti.
Membri obbligatori | Tipo di membro | Note |
---|---|---|
RowCount | Proprietà | Nessuno |
ColumnCount | Proprietà | Nessuno |
GetItem | Metodo | Nessuno |
Questo pattern di controllo non ha eventi associati.
Argomenti correlati
-
tipi di controllo e i relativi modelli di controllo supportati
-
Panoramica modelli di controllo di automazione interfaccia utente