Textobjektmodell

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit dem Textobjektmodell (Text Object Model, TOM) verwendet werden.

Das TOM definiert einen beträchtlichen Satz von Textbearbeitungsschnittstellen. Textlösungen wie Microsoft Word und rich edit-Steuerelemente unterstützen den TOM-Featuresatz. TOM wurde durch WordBasic (die für Word verwendete Programmiersprache) stark beeinflusst und ist über Microsoft Visual Basic for Applications (VBA) einfach zu verwenden. Diese Kompatibilität hat mehrere Vorteile:

  • Code kann relativ einfach von einer Lösung zu einer anderen migriert werden.
  • Eine Sprache kann verwendet werden, um Textinformationen zwischen verschiedenen Text-Engines gemeinsam zu verwenden.
  • Im Vergleich zu den separaten COM- und VBA-Schnittstellen (Low-Level Component Object Model) wird der Bedarf an Dokumentation und Code reduziert.

Es kann jedoch für C/C++-Zwecke weniger effizient sein als die Verwendung allgemeinerer COM-Schnittstellen auf niedrigerer Ebene.

TOM ist ein einfacher Satz von Schnittstellen, die für die primären Textlösungen, Word- und Rich Edit-Steuerelemente, implementiert werden müssen. Für Anwendungen, bei denen der Schwerpunkt auf Text liegt, ist es jedoch besser, TOM-Schnittstellen zur Verfügung zu stellen, indem der Text an ein Bearbeitungssteuerfeld übertragen wird, das TOM unterstützt. Da umfangreiche Bearbeitungssteuerelemente mit Microsoft-Betriebssystemen eingeführt werden, sind sie das Standardverfahren zum Abrufen von TOM-Funktionen.

Übersichten

Thema Inhalte
Informationen zum Textobjektmodell Das ToM-Objekt (Text Object Model) der obersten Ebene wird von der ITextDocument-Schnittstelle definiert, die Methoden zum Erstellen und Abrufen von Objekten weiter unten in der Objekthierarchie enthält.
Verwenden des Textobjektmodells Die Codebeispiele in diesem Dokument zeigen verschiedene Aspekte der Verwendung des Textobjektmodells (Text Object Model, TOM).

Schnittstellen

Thema Inhalte
ITextDocument Die ITextDocument-Schnittstelle ist die TOM-Schnittstelle der obersten Ebene, die die aktiven Auswahl- und Bereichsobjekte für jede Story im Dokument abruft, ob aktiv oder nicht. Dadurch kann die Anwendung:
Wann muss implementiert werden?
Anwendungen implementieren in der Regel nicht die ITextDocument-Schnittstelle. Microsoft-Textlösungen, z. B. umfangreiche Bearbeitungssteuerelemente, implementieren ITextDocument als Teil ihrer TOM-Implementierung.
Verwendung
Anwendungen können einen ITextDocument-Zeiger aus einem Rich-Edit-Steuerelement abrufen. Senden Sie hierzu eine EM_GETOLEINTERFACE, um ein IRichEditOle-Objekt aus einem Rich-Edit-Steuerelement abzurufen. Rufen Sie dann die IUnknown::QueryInterface-Methode des Objekts auf, um einen ITextDocument-Zeiger abzurufen.
ITextFont Auf TOM-Rich-Textbereich-Attribute wird über ein Paar von zwei Schnittstellen zugegriffen: ITextFont und ITextPara.
ITextPara Auf TOM-Rich-Textbereich-Attribute wird über ein Paar von zwei Schnittstellen zugegriffen: ITextFont und ITextPara.
ITextRange Die ITextRange-Objekte sind leistungsstarke Bearbeitungs- und Datenbindungstools, mit denen ein Programm Text in einer Geschichte auswählen und diesen Text dann untersuchen oder ändern kann.
ITextSelection Eine Textauswahl ist ein Textbereich mit Auswahlhervorhebung.
ITextStoryRanges Der Zweck der ITextStoryRanges-Schnittstelle besteht im Aufzählen der Storys in einem ITextDocument.