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

Steuerelementmuster für Kalkulationstabellen

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur