Condividi tramite


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

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).

    esempio di un controllo griglia con coordinate vuote

  • 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.

tipi di controllo e i relativi modelli di controllo supportati

modello di controllo GridItem

Panoramica modelli di controllo di automazione interfaccia utente

panoramica dell'albero di automazione interfaccia utente