Condividi tramite


Pattern di controllo griglia

Vengono descritte le linee guida e le convenzioni per l'implementazione di IGridProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo Griglia 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.

In questo argomento sono contenute 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 Microsoft Automazione interfaccia utente per supportare la proprietà IGridItemProvider::ContainingGrid per tale cella. Ciò è possibile quando il layout degli elementi figlio nella griglia è simile a una matrice irregolare (vedere l'esempio riportato di seguito).

    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 non ha importanza.

  • Le righe e le colonne nascoste, a seconda dell'implementazione del provider, possono essere caricate nell'albero Automazione interfaccia utente e pertanto verranno riflesse nelle proprietà IGridProvider::RowCount e ColumnCount. Se le righe e colonne nascoste non sono ancora state caricate, non devono essere contate.

  • IGridProvider non abilita la manipolazione attiva di una griglia; ITransformProvider deve essere implementato per abilitare questa funzionalità.

  • Usare un oggetto IUIAutomationStructureChangedEventHandler per ascoltare le modifiche strutturali o di layout alla griglia, ad esempio le celle aggiunte, rimosse o unite.

  • Usare IUIAutomationFocusChangedEventHandler per tenere traccia dell'attraversamento tra gli elementi o le celle di una griglia.

Membri obbligatori per IGridProvider

Per implementare l'interfaccia IGridProvider sono 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 è associato a eventi.

Tipi di controllo e modelli di controllo supportati

Pattern di controllo GridItem

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente