Partilhar via

Modelo de objeto de texto

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com o modelo de objeto de texto (TOM).

O TOM define um conjunto substancial de interfaces de manipulação de texto. Soluções de texto, como o Microsoft Word e controles de edição avançada, suportam o conjunto de recursos TOM. TOM foi muito influenciado pelo WordBasic (a linguagem de programação usada para o Word) e é fácil de usar do Microsoft Visual Basic for Applications (VBA). Esta compatibilidade tem várias vantagens:

  • O código pode migrar com bastante facilidade de uma solução para outra.
  • Um idioma pode ser usado para compartilhar informações de texto entre diferentes mecanismos de texto.
  • Ele reduz a necessidade de documentação e código em comparação com as interfaces COM (Component Object Model) e VBA separadas de baixo nível.

No entanto, pode ser menos eficiente para fins de C/C++ do que o uso de interfaces COM de nível inferior mais gerais.

TOM é um conjunto simples de interfaces para implementar para suas soluções de texto primário, Word e controles de edição avançada. No entanto, para aplicativos que dão pouca ênfase ao texto, é melhor fornecer interfaces TOM transferindo o texto para um controle de edição que suporte TOM. Como os controles de edição avançados são fornecidos com os sistemas operacionais da Microsoft, eles são o meio padrão de obter a funcionalidade TOM.

Visão geral

Tópico Índice
Sobre o modelo de objeto de texto O objeto TOM (Text Object Model) de nível superior é definido pela interfaceITextDocument, que tem métodos para criar e recuperar objetos inferiores na hierarquia de objetos.
Usando o modelo de objeto de texto Os exemplos de código neste documento mostram vários aspetos do uso do modelo de objeto de texto (TOM).

Interfaces

Tópico Índice
ITextDocument A interface ITextDocument é a interface de nível superior TOM, que recupera a seleção ativa e os objetos de intervalo para qualquer história no documento, esteja ativa ou não. Permite à aplicação:
  • Abra e salve documentos.
  • Controle o comportamento de desfazer e atualize a tela.
  • Encontre um intervalo a partir de uma posição de ecrã.
  • Obtenha um ITextStoryRanges enumerador de histórias.

Quando implementar
Os aplicativos normalmente não implementam o ITextDocument interface. Soluções de texto da Microsoft, como controles de edição avançada, implementam ITextDocument como parte de sua implementação TOM.
Quando usar
Os aplicativos podem recuperar um ponteiro deITextDocumentde um controle de edição avançado. Para fazer isso, envie uma mensagem de EM_GETOLEINTERFACE para recuperar um objetoIRichEditOlede um controle de edição avançado. Em seguida, chame o do objeto IUnknown::QueryInterface método para recuperar um ponteiro ITextDocument.
ITextFont Os atributos de intervalo de rich text TOM são acessados por meio de um par de interfaces duplas, ITextFont e ITextPara.
ITextPara Os atributos de intervalo de rich text TOM são acessados por meio de um par de interfaces duplas, ITextFont e ITextPara.
ITextRange Os objetos ITextRange são poderosas ferramentas de edição e vinculação de dados que permitem que um programa selecione texto em uma matéria e, em seguida, examine ou altere esse texto.
ITextSelection Uma seleção de texto é um intervalo de texto com realce de seleção.
ITextStoryRanges O objetivo do interface ITextStoryRanges é enumerar as histórias em um ITextDocument.