Modello di controllo SpreadsheetItem
Vengono descritte linee guida e convenzioni per l'implementazione di ISpreadsheetItemProvider, incluse informazioni sulle proprietà e sui metodi. Il modello di controllo SpreadsheetItem viene usato per esporre le proprietà di una cella in un foglio di calcolo o in un altro documento basato su griglia.
Il modello di controllo SpreadsheetItem è strettamente correlato al modello di controllo GridItem ; i controlli che implementano il modello di controllo SpreadsheetItem devono implementare anche il modello di controllo GridItem. I controlli possono anche implementare il modello di controllo TableItem , se appropriato. Per esempi di controlli che implementano questi modelli di controllo, vedere Tipi di controllo e modelli di controllo supportati.
In questo argomento sono contenute le sezioni seguenti.
- Linee guida e convenzioni di implementazione
- Membri obbligatori per ISpreadsheetItemProvider
- Argomenti correlati
Linee guida e convenzioni di implementazione
Quando si implementa il modello di controllo SpreadsheetItem , prendere nota delle linee guida e delle convenzioni seguenti:
- Quando si implementano i metodi ISpreadsheetItemProvider::GetAnnotationObjects e ISpreadsheetItemProvider::GetAnnotationTypes, vedere la documentazione di IAnnotationProvider. Questi metodi restituiscono entrambe le matrici per consentire ai provider di supportare più annotazioni in una singola cella.
- Alcuni tipi di annotazioni non richiedono un'implementazione completa dell'interfaccia IAnnotationProvider . Ad esempio, un semplice indicatore di errore ortografico può essere rappresentato da getAnnotationTypes restituisce un identificatore di attributo di testo di AnnotationType_SpellingError e avere GetAnnotationObjects restituisce un valore Null.
Membri obbligatori per ISpreadsheetItemProvider
Per implementare l'interfaccia ISpreadsheetItemProvider , sono necessari i metodi e le proprietà seguenti.
| Membri obbligatori | Tipo di membro | Note |
|---|---|---|
| Formula | Proprietà | L'implementazione di una proprietà Formula separata è necessaria perché la proprietà Value di una cella restituisce in genere il valore calcolato della cella. La proprietà Formula deve essere NULL se non è impostata alcuna formula. |
| GetAnnotationObjects | Metodo | Restituisce una matrice di provider di elementi che fanno riferimento alle annotazioni collegate a questa cella. I puntatori all'interno della matrice possono essere Null se un'annotazione non ha un provider collegato. |
| GetAnnotationTypes | Metodo | Restituisce una matrice di identificatori di tipo di annotazione che descrivono le annotazioni in questa cella. La matrice deve essere la stessa dimensione della matrice restituita da GetAnnotationObjects. |
Questo pattern di controllo non è associato a eventi.
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente
-
Panoramica dell'albero di automazione dell'interfaccia utente