Modello a oggetti di testo

  • Articolo

Questa sezione contiene informazioni sugli elementi di programmazione usati con il modello a oggetti di testo (TOM).

TOM definisce un set sostanziale di interfacce di manipolazione del testo. Le soluzioni di testo, ad esempio Microsoft Word e i controlli di modifica avanzata, supportano il set di funzionalità TOM. TOM è stato notevolmente influenzato da WordBasic (il linguaggio di programmazione usato per Word) ed è facile da usare da Microsoft Visual Basic, Applications Edition (VBA). Questa compatibilità presenta diversi vantaggi:

  • Il codice può eseguire la migrazione abbastanza facilmente da una soluzione a un'altra.
  • Una lingua può essere usata per condividere informazioni di testo tra motori di testo diversi.
  • Riduce la necessità di documentazione e codice rispetto alle interfacce COM (Component Object Model) e VBA separate.

Tuttavia, può essere meno efficiente per scopi C/C++ rispetto all'uso di interfacce COM di livello inferiore più generali.

TOM è un set semplice di interfacce da implementare per le sue principali soluzioni di testo, Word e controlli di modifica avanzati. Tuttavia, per le applicazioni che pongono un'enfasi minore sul testo, è preferibile fornire interfacce TOM trasferendo il testo a un controllo di modifica che supporta TOM. Poiché i controlli di modifica avanzati vengono forniti con i sistemi operativi Microsoft, sono i mezzi standard per ottenere la funzionalità TOM.

Panoramiche

Argomento Contenuto
Informazioni sul modello a oggetti di testo L'oggetto Text Object Model (TOM) di primo livello è definito dall'interfaccia ITextDocument , che dispone di metodi per la creazione e il recupero di oggetti inferiori nella gerarchia di oggetti.
Utilizzo del modello a oggetti di testo Gli esempi di codice in questo documento illustrano vari aspetti dell'uso del modello a oggetti di testo (TOM).

Interfacce

Argomento Contenuto
ITextDocument L'interfaccia ITextDocument è l'interfaccia di primo livello TOM, che recupera la selezione attiva e gli oggetti intervallo per qualsiasi brano del documento, indipendentemente dal fatto che sia attivo o meno. Consente all'applicazione di:
  • Aprire e salvare documenti.
  • Controllare il comportamento di annullamento e l'aggiornamento dello schermo.
  • Trovare un intervallo da una posizione dello schermo.
  • Ottenere un enumeratore di storia ITextStoryRanges.

Quando implementare
Le applicazioni in genere non implementano l'interfaccia ITextDocument . Le soluzioni di testo Microsoft, ad esempio i controlli rich edit, implementano ITextDocument come parte dell'implementazione tom.
Utilizzo
Le applicazioni possono recuperare un puntatore ITextDocument da un controllo di modifica avanzato. A tale scopo, inviare un messaggio di EM_GETOLEINTERFACE per recuperare un oggetto IRichEditOle da un controllo rich edit. Chiamare quindi il metodo IUnknown::QueryInterface dell'oggetto per recuperare un puntatore ITextDocument.
ITextFont È possibile accedere agli attributi rtf dell'intervallo di testo TOM tramite una coppia di interfacce doppie, ITextFont e ITextPara.
ITextPara È possibile accedere agli attributi rtf dell'intervallo di testo TOM tramite una coppia di interfacce doppie, ITextFont e ITextPara.
ITextRange Gli oggetti ITextRange sono potenti strumenti di modifica e data binding che consentono a un programma di selezionare il testo in un brano e quindi esaminare o modificare il testo.
ITextSelection Una selezione di testo è un intervallo di testo con evidenziazione della selezione.
ITextStoryRanges Lo scopo dell'interfaccia ITextStoryRanges è enumerare le storie in un ITextDocument.