Freigeben über


Textobjektmodell

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

Das TOM definiert einen umfangreichen Satz von Textbearbeitungsschnittstellen. Textlösungen wie Microsoft Word und umfangreiche Bearbeitungssteuerelemente unterstützen den TOM-Featuresatz. TOM wurde stark von WordBasic (der Programmiersprache für Word) beeinflusst und ist von 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 Textmodulen gemeinsam zu nutzen.
  • Dies reduziert den Bedarf an Dokumentation und Code im Vergleich zu den separaten low-level Component Object Model (COM) und VBA-Schnittstellen.

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 umfassende Bearbeitungssteuerelemente implementiert werden müssen. Für Anwendungen, die nur einen geringen Schwerpunkt auf Text legen, ist es jedoch besser, TOM-Schnittstellen bereitzustellen, indem der Text in ein Bearbeitungssteuerelement übertragen wird, das TOM unterstützt. Da umfangreiche Bearbeitungssteuerelemente mit Microsoft-Betriebssystemen ausgeliefert werden, sind sie die Standardmethode 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 enthält, die in der Objekthierarchie niedriger sind.
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 alle Storys im Dokument abruft, unabhängig davon, ob aktiv oder nicht. Es ermöglicht der Anwendung Folgendes:
  • Öffnen und speichern Sie Dokumente.
  • Steuern sie das Rückgängig-Verhalten und die Bildschirmaktualisierung.
  • Suchen Sie einen Bereich von einer Bildschirmposition aus.
  • Rufen Sie einen ITextStoryRanges-Story-Enumerator ab.

Gründe für die Implementierung
Anwendungen implementieren die ITextDocument-Schnittstelle in der Regel nicht. Microsoft-Textlösungen, z. B. Rich-Bearbeitungssteuerelemente, implementieren ITextDocument als Teil ihrer TOM-Implementierung.
Verwendungs-Gründe
Anwendungen können einen ITextDocument-Zeiger aus einem umfangreichen Bearbeitungssteuerelement abrufen. Senden Sie hierzu eine EM_GETOLEINTERFACE Nachricht, um ein IRichEditOle-Objekt aus einem umfangreichen Bearbeitungssteuerelement abzurufen. Rufen Sie dann die IUnknown::QueryInterface-Methode des Objekts auf, um einen ITextDocument-Zeiger abzurufen.
ITextFont Auf TOM-Rich-Textbereichsattribute kann über ein Paar von dualen Schnittstellen zugegriffen werden: ITextFont und ITextPara.
ITextPara Auf TOM-Rich-Textbereichsattribute kann über ein Paar von dualen Schnittstellen zugegriffen werden: ITextFont und ITextPara.
ITextRange Die ITextRange-Objekte sind leistungsstarke Bearbeitungs- und Datenbindungstools, mit denen ein Programm Text in einem Textabschnitt auswählen und diesen dann untersuchen oder ändern kann.
ITextSelection Eine Textauswahl ist ein Textbereich mit Markierungsmarkierung.
ITextStoryRanges Der Zweck der ITextStoryRanges-Schnittstelle besteht darin, die Storys in einem ITextDocument aufzulisten.