Compartilhar via

Modelo de objeto de texto

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com o TOM (Modelo de Objeto de Texto).

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 dão 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 do Microsoft Visual Basic for Applications (VBA). Essa compatibilidade tem várias vantagens:

  • O código pode migrar facilmente 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 (Modelo de Objeto de Componente) e VBA separadas.

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

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

Súmulas

Tópico Conteúdo
sobre o modelo de objeto de texto O objeto TOM (Modelo de Objeto de Texto) de nível superior é definido pela interfaceITextDocument, que tem métodos para criar e recuperar objetos mais baixos 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 TOM (Modelo de Objeto de Texto).

Interfaces

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

Quando implementar
Normalmente, os aplicativos não implementam a interface deITextDocument. 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 ponteiroITextDocument de um controle de edição avançada. Para fazer isso, envie uma mensagem 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 de intervalo de texto avançados tom são acessados por meio de um par de interfaces duplas, ITextFont e ITextPara.
ITextPara Os atributos de intervalo de texto avançados tom são acessados por meio de um par de interfaces duplas, ITextFont e ITextPara.
ITextRange Os objetos ITextRange são ferramentas avançadas de edição e associação de dados que permitem que um programa selecione texto em uma histó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 A finalidade da interfaceITextStoryRanges é enumerar as histórias em umITextDocument.