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 wesentlichen Satz von Textmanipulationsschnittstellen. Textlösungen wie Microsoft Word und Rich-Edit-Steuerelemente unterstützen den TOM-Featuresatz. TOM wurde stark von WordBasic (der programmiersprache, die für Word verwendet wird) beeinflusst, und es ist einfach, aus Microsoft Visual Basic für Applikationen (VBA) zu verwenden. Diese Kompatibilität hat mehrere Vorteile:

  • Code kann relativ einfach von einer Lösung zu einer anderen migriert werden.
  • Eine Sprache kann zum Freigeben von Textinformationen zwischen verschiedenen Textmodulen verwendet werden.
  • Es reduziert die Notwendigkeit von Dokumentation und Code im Vergleich zu den separaten Komponentenobjektmodell (COM) und VBA-Schnittstellen auf niedriger Ebene.

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

TOM ist eine einfache Gruppe von Schnittstellen, die für ihre primären Textlösungen, Word und Rich-Edit-Steuerelemente implementiert werden sollen. Für Anwendungen, bei denen Text geringfügig hervorgehoben wird, empfiehlt es sich jedoch, TOM-Schnittstellen bereitzustellen, indem der Text in ein Bearbeitungssteuerelement übertragen wird, das TOM unterstützt. Da umfangreiche Bearbeitungssteuerelemente mit Microsoft-Betriebssystemen geliefert werden, sind sie die Standardmittel zum Abrufen von TOM-Funktionen.

Überblicke

Thema Inhalt
zu Textobjektmodell- Das TEXT Object Model (TOM)-Objekt der obersten Ebene wird durch die 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 Inhalt
ITextDocument- Die ITextDocument- Schnittstelle ist die Schnittstelle der obersten Ebene von TOM, die die aktiven Auswahl- und Bereichsobjekte für einen Beliebigen Textabschnitt im Dokument abruft, unabhängig davon, ob aktiv oder nicht. Sie ermöglicht der Anwendung Folgendes:
  • Öffnen und Speichern von Dokumenten
  • Steuern des Rückgängig-Verhaltens und der Bildschirmaktualisierung.
  • Suchen Sie einen Bereich von einer Bildschirmposition.
  • Abrufen eines ITextStoryRanges Story-Enumerator.

Wann implementiert werden soll
Anwendungen implementieren in der Regel nicht die ITextDocument- Schnittstelle. Microsoft-Textlösungen wie Rich-Edit-Steuerelemente implementieren ITextDocument- als Teil ihrer TOM-Implementierung.
Wann
Anwendungen können ein ITextDocument- Zeiger aus einem Rich-Edit-Steuerelement abrufen. Senden Sie hierzu eine EM_GETOLEINTERFACE Nachricht, 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 TOM-Rich-Text-Bereich-Attribute werden über ein Paar dualer Schnittstellen, ITextFont und ITextPara-zugegriffen.
ITextPara- TOM-Rich-Text-Bereich-Attribute werden über ein Paar dualer Schnittstellen, ITextFont und ITextPara-zugegriffen.
ITextRange- Die ITextRange Objekte sind leistungsstarke Bearbeitungs- und Datenbindungstools, mit denen ein Programm Text in einem Textabschnitt markieren und diesen Text dann untersuchen oder ändern kann.
ITextSelection- Eine Textauswahl ist ein Textbereich mit Markierungsmarkierung.
ITextStoryRanges- Der Zweck der ITextStoryRanges Schnittstelle besteht darin, die Artikel in einem ITextDocument-aufzählen.