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 SpreadsheetItem-Steuerelementmuster 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 Elemente 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 IAnnotationProvider-Dokumentation . Diese Methoden geben beide 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 könnte ein einfacher Rechtschreibfehlerindikator dargestellt werden, indem GetAnnotationTypes einen Text-Attributbezeichner von AnnotationType_SpellingError und GetAnnotationObjects einen NULL-Wert zurückgibt.
Erforderliche Elemente 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 Formula-Eigenschaft 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 anmerkungen verweisen, die mit dieser Zelle verknüpft sind. Zeiger innerhalb des Arrays können NULL sein, wenn eine Anmerkung keinen verknüpften Anbieter aufweist. |
| 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 von GetAnnotationObjects zurückgegebene Array aufweisen. |
Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.
Zugehörige Themen
-
Konzept
-
Steuerelementtypen und deren unterstützte Steuerelementmuster
-
Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung
-
Übersicht über die Benutzeroberflächenautomatisierungs-Struktur