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

  

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

Argomenti correlati

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