Partager via

Modèle objet texte

  • Article

Cette section contient des informations sur les éléments de programmation utilisés avec le modèle d’objet texte (TOM).

Le TOM définit un ensemble substantiel d’interfaces de manipulation de texte. Les solutions de texte telles que Microsoft Word et les contrôles d’édition enrichis prennent en charge l’ensemble de fonctionnalités TOM. TOM a été fortement influencé par WordBasic (le langage de programmation utilisé pour Word) et il est facile à utiliser à partir de Microsoft Visual Basic pour Applications (VBA). Cette compatibilité présente plusieurs avantages :

  • Le code peut migrer assez facilement d’une solution à une autre.
  • Une langue peut être utilisée pour partager des informations de texte entre différents moteurs de texte.
  • Cela réduit le besoin de documentation et de code par rapport aux interfaces COM (Component Object Model) et VBA distinctes.

Toutefois, elle peut être moins efficace à des fins C/C++ que l’utilisation d’interfaces COM de niveau inférieur plus général.

TOM est un ensemble simple d’interfaces à implémenter pour ses solutions de texte principales, Word et contrôles d’édition enrichis. Toutefois, pour les applications qui mettent l’accent sur le texte, il est préférable de fournir des interfaces TOM en transférant le texte vers un contrôle d’édition qui prend en charge TOM. Étant donné que les contrôles d’édition enrichis sont fournis avec les systèmes d’exploitation Microsoft, ils sont le moyen standard d’obtenir des fonctionnalités TOM.

Vues d'ensemble

Rubrique Contenu
À propos du modèle objet texte L’objet TOM (Text Object Model) de niveau supérieur est défini par l’interface ITextDocument , qui a des méthodes pour créer et récupérer des objets plus bas dans la hiérarchie d’objets.
Utilisation du modèle objet texte Les exemples de code de ce document montrent différents aspects de l’utilisation du modèle d’objet texte (TOM).

Interfaces

Rubrique Contenu
ITextDocument L’interface ITextDocument est l’interface tom de niveau supérieur, qui récupère les objets de sélection et de plage actifs pour n’importe quel article du document, qu’il soit actif ou non. Elle permet à l’application de :
  • Ouvrez et enregistrez des documents.
  • Contrôler le comportement d’annulation et la mise à jour de l’écran.
  • Recherchez une plage à partir d’une position d’écran.
  • Obtenez un énumérateur d’histoire ITextStoryRanges .

Quand implémenter
En général, les applications n’implémentent pas l’interface ITextDocument . Les solutions de texte Microsoft, telles que les contrôles d’édition enrichis, implémentent ITextDocument dans le cadre de leur implémentation TOM.
Quand utiliser
Les applications peuvent récupérer un pointeur ITextDocument à partir d’un contrôle d’édition enrichi. Pour ce faire, envoyez un message EM_GETOLEINTERFACE pour récupérer un objet IRichEditOle à partir d’un contrôle d’édition enrichi. Ensuite, appelez la méthode IUnknown::QueryInterface de l’objet pour récupérer un pointeur ITextDocument .
ITextFont Les attributs de plage de texte enrichi TOM sont accessibles via une paire d’interfaces doubles, ITextFont et ITextPara.
ITextPara Les attributs de plage de texte enrichi TOM sont accessibles via une paire d’interfaces doubles, ITextFont et ITextPara.
ITextRange Les objets ITextRange sont de puissants outils d’édition et de liaison de données qui permettent à un programme de sélectionner du texte dans un article, puis d’examiner ou de modifier ce texte.
ITextSelection Une sélection de texte est une plage de texte avec sélection mise en surbrillance.
ITextStoryRanges L’objectif de l’interface ITextStoryRanges est d’énumérer les récits dans un ITextDocument.