Sdílet prostřednictvím


Textový objektový model

Tato část obsahuje informace o programovacích prvcích používaných s objektovým modelem (TOM).

Tom definuje podstatnou sadu rozhraní pro manipulaci s textem. Textová řešení, jako je Microsoft Word a ovládací prvky pro úpravy s formátováním, podporují sadu funkcí TOM. Tom byl výrazně ovlivněn WordBasic (programovací jazyk používaný pro Word) a snadno se používá z jazyka Microsoft Visual Basic for Applications (VBA). Tato kompatibilita má několik výhod:

  • Kód se dá poměrně snadno migrovat z jednoho řešení do druhého.
  • Jeden jazyk lze použít ke sdílení textových informací mezi různými textovými moduly.
  • Snižuje potřebu dokumentace a kódu v porovnání s samostatnými rozhraními MODELU COM (Low-Level Component Object Model) a VBA.

Může však být méně efektivní pro účely C/C++, než použití obecnějších rozhraní MODELU COM nižší úrovně.

TOM je jednoduchá sada rozhraní pro implementaci pro primární textová řešení, Word a ovládací prvky pro úpravy s formátováním. U aplikací, které na text klade menší důraz, je ale lepší poskytnout rozhraní TOM tak, že text přenesete do ovládacího prvku pro úpravy, který podporuje TOM. Vzhledem k tomu, že bohaté ovládací prvky pro úpravy jsou dodávány s operačními systémy Microsoftu, představují standardní způsob získání funkčnosti TOM.

Přehledy

Námět Obsah
o textového objektového modelu Objekt TOM (Text Object Model) nejvyšší úrovně je definován rozhraním ITextDocument, které má metody pro vytváření a načítání objektů nižších v hierarchii objektů.
použití textového objektového modelu Ukázky kódu v tomto dokumentu ukazují různé aspekty použití textového objektového modelu (TOM).

Rozhraní

Námět Obsah
ITextDocument Rozhraní ITextDocument je rozhraní nejvyšší úrovně TOM, které načte aktivní výběr a rozsah objektů pro jakýkoli text v dokumentu bez ohledu na to, zda je aktivní nebo ne. Umožňuje aplikaci:
  • Otevřete a uložte dokumenty.
  • Řízení chování vrácení zpět a aktualizace obrazovky
  • Najděte rozsah od pozice obrazovky.
  • Získejte ITextStoryRanges výčtu textu.

Kdy implementovat
Aplikace obvykle neimplementují rozhraní ITextDocument. Textová řešení Microsoftu, jako jsou ovládací prvky pro úpravy s formátováním, implementují ITextDocument jako součást implementace TOM.
Kdy použít
Aplikace mohou načíst ITextDocument ukazatel z ovládacího prvku pro úpravy s formátem. Uděláte to tak, že odešlete EM_GETOLEINTERFACE zprávu, která načte objekt IRichEditOle z ovládacího prvku pro úpravy s formátovaným formátem. Potom zavolejte objekt IUnknown::QueryInterface metoda načtení ITextDocument ukazatel.
ITextFont Atributy formátovaného textu TOM jsou přístupné prostřednictvím dvojice duálních rozhraní, ITextFont a ITextPara.
ITextPara Atributy formátovaného textu TOM jsou přístupné prostřednictvím dvojice duálních rozhraní, ITextFont a ITextPara.
ITextRange Objekty ITextRange jsou výkonné nástroje pro úpravy a datové vazby, které programu umožňují vybrat text v textu a pak text prozkoumat nebo změnit.
ITextSelection Výběr textu je oblast textu se zvýrazněním výběru.
ITextStoryRanges Účelem rozhraní ITextStoryRanges je výčet příběhů v ITextDocument.