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, oferecem suporte ao conjunto de recursos TOM. TOM foi muito influenciado pelo WordBasic (a linguagem de programação usada para o Word) e é fácil de usar a partir 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, ele 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 ofereça suporte a 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ões gerais

Tópico Contents
Sobre o modelo de objeto de texto O objeto TOM (Text Object Model) de nível superior é definido pela interface ITextDocument , 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 aspectos do uso do Text Object Model (TOM).

Interfaces

Tópico Contents
ITextDocument A interface ITextDocument é a interface de nível superior do TOM, que recupera os objetos de seleção e intervalo ativos para qualquer matéria no documento, ativa ou não. Ele permite que o aplicativo:
  • Abra e salve documentos.
  • Controle o comportamento de desfazer e a atualização da tela.
  • Encontre um intervalo a partir de uma posição de tela.
  • Obtenha um enumerador de histórias ITextStoryRanges.

Quando implementar
Os aplicativos normalmente não implementam a interface ITextDocument. As 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 ITextDocument de um controle de edição avançado. Para fazer isso, envie uma mensagem de EM_GETOLEINTERFACE para recuperar um objeto IRichEditOle de um controle de edição avançada. Em seguida, chame o método IUnknown::QueryInterface do objeto para recuperar um ponteiro ITextDocument.
ITextFont Os atributos TOM rich text-range são acessados por meio de um par de interfaces duplas, ITextFont e ITextPara.
ITextPara Os atributos TOM rich text-range 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 da interface ITextStoryRanges é enumerar as histórias em um ITextDocument.