SpreadsheetItem-Steuerelementmuster
Beschreibt Richtlinien und Konventionen für die Implementierung von ISpreadsheetItemProvider,einschließlich Informationen zu Eigenschaften und Methoden. Das SpreadsheetItem-Steuerelementmuster wird verwendet, um die Eigenschaften einer Zelle in einer Kalkulationstabelle oder einem anderen rasterbasierten Dokument verfügbar zu machen.
Das SpreadsheetItem-Steuerelementmuster ist eng mit dem GridItem-Steuerelementmuster verknüpft. -Steuerelemente, die das Steuerelementmuster SpreadsheetItem implementieren, sollten auch das GridItem-Steuerelementmuster implementieren. Steuerelemente können ggf. auch das TableItem-Steuerelementmuster implementieren. Beispiele für Steuerelemente, die diese Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.
Dieses Thema enthält folgende Abschnitte:
- Implementierungsrichtlinien und -konventionen
- Erforderliche Member für ISpreadsheetItemProvider
- Zugehörige Themen
Implementierungsrichtlinien und -konventionen
Beachten Sie beim Implementieren des SpreadsheetItem-Steuerelementmusters die folgenden Richtlinien und Konventionen:
- Wenn Sie die Methoden ISpreadsheetItemProvider::GetAnnotationObjects und ISpreadsheetItemProvider::GetAnnotationTypes implementieren, lesen Sie die Dokumentation zu IAnnotationProvider. Beide Methoden geben Arrays zurück, damit Anbieter mehrere Anmerkungen in einer einzelnen Zelle unterstützen können.
- Einige Arten von Anmerkungen erfordern keine vollständige Implementierung der IAnnotationProvider-Schnittstelle. Beispielsweise kann ein einfacher Rechtschreibfehlerindikator dargestellt werden, indem GetAnnotationTypes einen Textattributbezeichner von AnnotationType _ SpellingErrorzurückgibt und GetAnnotationObjects einen NULL-Wert zurückgibt.
Erforderliche Member für ISpreadsheetItemProvider
Die folgenden Eigenschaften und Methoden sind für die Implementierung der ISpreadsheetItemProvider-Schnittstelle erforderlich.
| Erforderliche Member | Memberart | Hinweise |
|---|---|---|
| Formel | Eigenschaft | Die Implementierung einer separaten Formeleigenschaft ist erforderlich, da die Value-Eigenschaft einer Zelle in der Regel den berechneten Wert der Zelle zurückgibt. Die Formula-Eigenschaft sollte NULL sein, wenn keine Formel festgelegt ist. |
| GetAnnotationObjects | Methode | Gibt ein Array von Elementanbietern zurück, die auf die mit dieser Zelle verknüpften Anmerkungen verweisen. Zeiger innerhalb des Arrays können NULL sein, wenn eine Anmerkung keinen verknüpften Anbieter hat. |
| GetAnnotationTypes | Methode | Gibt ein Array von Anmerkungstypbezeichnern zurück, die die Anmerkungen in dieser Zelle beschreiben. Das Array muss die gleiche Größe wie das array haben, das von GetAnnotationObjectszurückgegeben wird. |
Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.