Model ovládacího prvku SpreadsheetItem
Popisuje pokyny a konvence pro implementaci ISpreadsheetItemProvider, včetně informací o vlastnostech a metodách. Vzor ovládacího prvku SpreadsheetItem slouží k zveřejnění vlastností buňky v tabulce nebo jiném dokumentu založeném na mřížce.
Vzor ovládacího prvku SpreadsheetItem úzce souvisí se vzorem ovládacích prvků GridItem; ovládací prvky, které implementují vzor ovládacích prvků SpreadsheetItem, by také měly implementovat vzor ovládacího prvku GridItem. Ovládací prvky mohou také implementovat vzor ovládacích prvků TableItem, pokud je to vhodné. Příklady ovládacích prvků, které implementují tyto vzory ovládacích prvků, naleznete v tématu typy ovládacích prvků a jejich podporované vzory ovládacích prvků.
Toto téma obsahuje následující části.
Pokyny a konvence implementace
Při implementaci modelu kontroly SpreadsheetItem si všimněte následujících pokynů a konvencí:
- Při implementaci ISpreadsheetItemProvider::GetAnnotationObjects a ISpreadsheetItemProvider::GetAnnotationTypes metody, projděte si dokumentaciIAnnotationProvider. Obě tyto metody vracejí pole, aby zprostředkovatelé podporovali více poznámek v jedné buňce.
- Některé druhy poznámek nevyžadují úplnou implementaci IAnnotationProvider rozhraní. Například jednoduchý indikátor chyby pravopisu může být reprezentován GetAnnotationTypes vrátit identifikátor textového atributu AnnotationType_SpellingErrora mít GetAnnotationObjects vrátit hodnotu null.
Požadované členy pro ISpreadsheetItemProvider
Pro implementaci rozhraní ISpreadsheetItemProvider jsou vyžadovány následující vlastnosti a metody.
| Požadované členy | Typ členu | Poznámky |
|---|---|---|
| vzorce | Vlastnost | Implementace samostatné vlastnosti vzorec je nutná, protože vlastnost Hodnota buňky obvykle vrátí vypočítanou hodnotu buňky. Vlastnost vzorce by měla být null, pokud není nastaven žádný vzorec. |
| GetAnnotationObjects | Metoda | Vrátí pole zprostředkovatelů prvků, které odkazují na poznámky propojené s touto buňkou. Ukazatele v rámci pole mohou mít hodnotu null, pokud poznámka neobsahuje propojeného zprostředkovatele. |
| getAnnotationTypes | Metoda | Vrátí pole identifikátorů typu poznámek, které popisují poznámky v této buňce. Pole musí mít stejnou velikost jako pole vrácené GetAnnotationObjects. |
Tento vzor ovládacího prvku nemá žádné přidružené události.
Související témata
-
koncepční
-
typy ovládacích prvků a jejich podporované vzory ovládacích prvků
-
Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní