Dela via


Textobjektmodell

Det här avsnittet innehåller information om de programmeringselement som används med textobjektmodellen (TOM).

TOM definierar en betydande uppsättning gränssnitt för textmanipulering. Textlösningar som Microsoft Word och rtf-redigeringskontroller stöder TOM-funktionsuppsättningen. TOM påverkades kraftigt av WordBasic (programmeringsspråket som används för Word) och det är enkelt att använda från Microsoft Visual Basic for Applications (VBA). Den här kompatibiliteten har flera fördelar:

  • Kod kan migrera ganska enkelt från en lösning till en annan.
  • Ett språk kan användas för att dela textinformation mellan olika textmotorer.
  • Det minskar behovet av dokumentation och kod jämfört med separata com- och VBA-gränssnitt (Component Object Model) på låg nivå.

Det kan dock vara mindre effektivt för C/C++-ändamål än användningen av mer allmänna COM-gränssnitt på lägre nivå.

TOM är en enkel uppsättning gränssnitt som ska implementeras för dess primära textlösningar, word- och rtf-redigeringskontroller. För program som lägger mindre vikt vid text är det dock bättre att tillhandahålla TOM-gränssnitt genom att överföra texten till en redigeringskontroll som stöder TOM. Eftersom omfattande redigeringskontroller levereras med Microsofts operativsystem är de standardmedlet för att få TOM-funktioner.

Översikter

Ämne Innehåll
Om textobjektmodell Tom-objektet (Text Object Model) på den översta nivån definieras av ITextDocument--gränssnittet, som har metoder för att skapa och hämta objekt längre ned i objekthierarkin.
med hjälp av textobjektmodellen Kodexemplen i det här dokumentet visar olika aspekter av hur du använder textobjektmodellen (TOM).

Gränssnitt

Ämne Innehåll
ITextDocument Det ITextDocument--gränssnittet är TOM-gränssnittet på den översta nivån, som hämtar aktiva markerings- och intervallobjekt för alla berättelser i dokumentet oavsett om de är aktiva eller inte. Det gör att programmet kan:
  • Öppna och spara dokument.
  • Kontrollera beteendet för ångra och uppdatera skärmen.
  • Hitta ett intervall från en skärmposition.
  • Hämta en ITextStoryRanges- berättelseuppräknare.

När ska
Program implementerar vanligtvis inte gränssnittet ITextDocument. Microsofts textlösningar, till exempel rtf-redigeringskontroller, implementerar ITextDocument- som en del av TOM-implementeringen.
När ska
Program kan hämta en ITextDocument- pekare från en omfattande redigeringskontroll. Det gör du genom att skicka ett EM_GETOLEINTERFACE meddelande för att hämta ett IRichEditOle- objekt från en omfattande redigeringskontroll. Anropa sedan objektets IUnknown::QueryInterface-metod för att hämta en ITextDocument- pekare.
ITextFont TOM RTF-attribut används via ett par dubbla gränssnitt, ITextFont och ITextPara.
ITextPara TOM RTF-attribut används via ett par dubbla gränssnitt, ITextFont och ITextPara.
ITextRange ITextRange- objekt är kraftfulla redigerings- och databindningsverktyg som gör att ett program kan välja text i en berättelse och sedan undersöka eller ändra texten.
ITextSelection En textmarkering är ett textområde med markeringen markerad.
ITextStoryRanges Syftet med ITextStoryRanges-gränssnittet är att räkna upp berättelserna i en ITextDocument-.