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.