Wzorzec kontrolki Arkusz kalkulacyjny
Opisuje wytyczne i konwencje implementowania ISpreadsheetItemProvider, w tym informacje o właściwościach i metodach. Wzorzec kontrolki Arkusz kalkulacyjny służy do uwidaczniania właściwości komórki w arkuszu kalkulacyjnym lub innym dokumencie opartym na siatce.
Wzorzec kontrolki Arkusz kalkulacyjny jest ściśle powiązany ze wzorcem kontrolki GridItem; kontrolki implementujące wzorzec kontrolki SpreadsheetItem powinny również implementować wzorzec kontrolki GridItem. Kontrolki mogą również implementować wzorzec kontrolki TableItem, jeśli jest to konieczne. Przykłady kontrolek, które implementują te wzorce kontrolek, zobacz Typy kontrolek i Obsługiwane wzorce kontrolek.
Ten temat zawiera następujące sekcje.
Wytyczne i konwencje implementacji
Podczas implementowania wzorca kontrolki SpreadsheetItem należy pamiętać o następujących wytycznych i konwencjach:
- Podczas implementowania metod ISpreadsheetItemProvider::GetAnnotationObjects i ISpreadsheetItemProvider::GetAnnotationTypes metod, zapoznaj się z dokumentacją IAnnotationProvider. Obie metody zwracają tablice, aby umożliwić dostawcom obsługę wielu adnotacji w jednej komórce.
- Niektóre rodzaje adnotacji nie wymagają pełnej implementacji interfejsu IAnnotationProvider. Na przykład prosty wskaźnik błędu pisowni może być reprezentowany przez GetAnnotationTypes zwrócić identyfikator atrybutu tekstowego AnnotationType_SpellingErrori GetAnnotationObjects zwrócić wartość null.
Wymagane elementy członkowskie ISpreadsheetItemProvider
Następujące właściwości i metody są wymagane do zaimplementowania interfejsu ISpreadsheetItemProvider.
| Wymagane elementy członkowskie | Typ elementu członkowskiego | Notatki |
|---|---|---|
| Formuła | Własność | Zaimplementowanie oddzielnej właściwości Formuła jest konieczne, ponieważ właściwość Value komórki zwykle zwraca obliczoną wartość komórki. Właściwość formuły powinna być NULL, jeśli nie ustawiono formuły. |
| GetAnnotationObjects | Metoda | Zwraca tablicę dostawców elementów odwołujących się do adnotacji połączonych z tą komórką. Wskaźniki w tablicy mogą mieć wartość null, jeśli adnotacja nie ma połączonego dostawcy. |
| GetAnnotationTypes | Metoda | Zwraca tablicę identyfikatorów typu adnotacji opisujących adnotacje w tej komórce. Tablica musi mieć taki sam rozmiar, jak tablica zwrócona przez GetAnnotationObjects. |
Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.
Tematy pokrewne
-
koncepcyjne
-
Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie