Modèle d'objet texte

Le modèle d'objet texte ( TOM ) est une API Microsoft Windows qui fournit aux développeurs des interfaces de manipulation de texte enrichi basées sur des objets. Il est implémenté via COM et est accessible via Microsoft Word ou via les contrôles RichEdit qui sont normalement fournis avec Windows.

Lors de son développement, TOM a été fortement influencé par WordBasic, un langage macro utilisé dans Word avant VBA ( Word 95 et versions précédentes). TOM a évolué parallèlement à la technologie RichEdit et est présent depuis la version 1.0 des composants RichEdit. L'API est disponible en option pour Windows CE depuis la version 2.5 de RichEdit (langues occidentales uniquement), qui était au moins utilisée par Pocket Word à cette époque.

La version 8.0 de RichEdit, fournie avec Windows 8 , a ajouté la prise en charge des mathématiques OpenType .

Pour récupérer une instance implémentée de ITextDocument l'interface (l'interface de document de niveau supérieur), le EM_GETOLEINTERFACEmessage peut être envoyé via l'API SendMessage pour obtenir un pointeur vers un IRichEditOleobjet, qui implémente également l' ITextDocumentinterface. TOM peut fonctionner différemment selon la version du contrôle RichEdit pour lequel l'interface est récupérée (les fenêtres RICHEDIT50W offrent plus de fonctionnalités que les contrôles RICHEDIT20W ou RICHEDIT20A standard, comme une prise en charge appropriée des tableaux).

Document texte

Une interface de niveau supérieur. Les documents peuvent être ouverts et enregistrés via cette interface. Un certain contrôle de mise à jour de l'écran est également réalisé ici. Le regroupement Annuler/Rétablir est implémenté ici. Des plages de texte arbitraires ( ITextRange ) et une plage de texte pour le texte actuellement sélectionné ( ITextSelection ) sont fournies, qui sont utilisées pour modifier ou réviser le document.

Plage de texte I

Fournit des outils d'édition et de liaison de données pour sélectionner du texte dans un document, qui peut être examiné, modifié ou supprimé. Des plages existent dans les paragraphes et le paragraphe dans lequel se trouve une plage est accessible via une propriété de cet objet.

Sélection de texte

Fournit des informations de sélection, en plus des fonctionnalités fournies par ITextRange .

Police de texte IText

Interface double avec ITextPara

Un mécanisme d'inspection et de modification des attributs de police d'édition enrichie, qui est considérablement plus étendu que l'interface OLE standard utilisée pour décrire une police (IFontDisp, StdFont).

ITextPara

Interface double avec ITextFont

Fournit des informations détaillées sur la position, le formatage en dehors des polices (par exemple, le retrait de la première ligne), le comportement (par exemple, le contrôle des fenêtres) et le but d'un paragraphe (il peut s'agir d'un paragraphe normal, d'une liste, d'un tableau, etc.).