Sdílet prostřednictvím

Přehled objektového modelu Wordu

  • Článek

Při vývoji wordových řešení v sadě Visual Studio pracujete s objektovým modelem Wordu. Tento objektový model se skládá z tříd a rozhraní poskytovaných v primárním sestavení vzájemné spolupráce pro Word a jsou definovány v Microsoft.Office.Interop.Word oboru názvů.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu a projekty doplňků VSTO pro Word. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Toto téma obsahuje stručný přehled objektového modelu Wordu. Další informace o celém objektovém modelu Wordu najdete v dokumentaci k objektu Wordu.

Informace o používání objektového modelu aplikace Word k provádění konkrétních úloh najdete v následujících tématech:

Principy objektového modelu Wordu

Word poskytuje stovky objektů, se kterými můžete pracovat. Tyto objekty jsou uspořádány v hierarchii, která úzce sleduje uživatelské rozhraní. V horní části hierarchie je Application objekt. Tento objekt představuje aktuální instanci aplikace Word. Objekt Application obsahuje objekty Document, Selection, Bookmarka Range objekty. Každý z těchto objektů má mnoho metod a vlastností, které můžete přistupovat k manipulaci s objektem a interakci s ním.

Následující obrázek znázorňuje jedno zobrazení těchto objektů v hierarchii objektového modelu Wordu.

Word Object Model graphic

Na první pohled se objekty zdánlivě překrývají. Objekty jsou například DocumentSelection oba členy objektu Application , ale Document objekt je také členem objektu Selection . Objekty DocumentSelection i objekty obsahují Bookmark i Range objekty. Překrytí existuje, protože existuje několik způsobů, jak můžete přistupovat ke stejnému typu objektu. Například formátování použijete u Range objektu, ale můžete chtít získat přístup k rozsahu aktuálního výběru, konkrétního odstavce, oddílu nebo celého dokumentu.

Následující části stručně popisují objekty nejvyšší úrovně a jejich vzájemné interakce. Mezi tyto objekty patří následující pět:

  • Objekt aplikace

  • Objekt dokumentu

  • Objekt výběru

  • rozsah – objekt

  • Objekt záložky

    Kromě objektového modelu Wordu poskytují projekty Office v sadě Visual Studio hostitelské položky a ovládací prvky hostitele, které rozšiřují některé objekty v objektovém modelu Wordu. Hostitelské položky a hostitelské ovládací prvky se chovají podobně jako objekty Aplikace Word, které rozšiřují, ale mají také další funkce, jako jsou funkce vazby dat a další události. Další informace najdete v tématu Automatizace wordu pomocí rozšířených objektů a položek hostitelů a přehledu ovládacích prvků hostitele.

Objekt aplikace

Objekt Application představuje aplikaci Word a je nadřazenou součástí všech ostatních objektů. Její členové se obvykle vztahují na Word jako celek. K řízení prostředí Wordu můžete použít jeho vlastnosti a metody.

V projektech doplňků VSTO můžete k objektu Application přistupovat pomocí Application pole ThisAddIn třídy. Další informace naleznete v tématu Program VSTO Doplňky.

V projektech na úrovni dokumentu můžete k objektu Application přistupovat pomocí Application vlastnosti ThisDocument třídy.

Objekt dokumentu

Objekt Document je centrální pro programování wordu. Představuje dokument a veškerý jeho obsah. Když otevřete dokument nebo vytvoříte nový dokument, vytvoříte nový Document objekt, který se přidá do Documents kolekce objektu Application . Dokument s fokusem se nazývá aktivní dokument. ActiveDocument Představuje vlastnost objektuApplication.

Nástroje pro vývoj pro Office v sadě Visual Studio rozšiřují Document objekt zadáním Document typu. Tento typ je hostitelská položka , která poskytuje přístup ke všem funkcím objektu Document a přidává další události a možnost přidávat spravované ovládací prvky.

Při vytváření projektu na úrovni dokumentu můžete přistupovat k Document členům pomocí vygenerované ThisDocument třídy v projektu. Ke členům Document položky hostitele můžete přistupovat pomocí klíčových slov Já nebo tato klíčová slova z kódu ve ThisDocument třídě nebo pomocí Globals.ThisDocument kódu mimo ThisDocument třídu. Další informace naleznete v tématu Program přizpůsobení na úrovni dokumentu. Pokud například chcete vybrat první odstavec v dokumentu, použijte následující kód.

this.Paragraphs[1].Range.Select();

V projektech doplňků VSTO můžete vygenerovat Document hostitelské položky za běhu. Vygenerovanou položku hostitele můžete použít k přidání ovládacích prvků do přidruženého dokumentu. Další informace naleznete v tématu Rozšíření wordových dokumentů a excelových sešitů v doplňkech VSTO za běhu.

Objekt výběru

Objekt Selection představuje oblast, která je aktuálně vybrána. Když provedete operaci v uživatelském rozhraní Wordu, například tučné písmo, vyberete nebo zvýrazníte text a pak formátování použijete. Objekt Selection se vždy nachází v dokumentu. Pokud není vybráno nic, představuje kurzor. Kromě toho výběr může zahrnovat více bloků textu, které nejsou souvislé.

rozsah – objekt

Objekt Range představuje souvislou oblast v dokumentu a je definována počátečním znakem pozice a koncovou pozicí znaku. Nejste omezeni na jeden Range objekt. Ve stejném dokumentu můžete definovat více Range objektů. Objekt Range má následující charakteristiky:

  • Může se skládat ze samotného kurzoru, rozsahu textu nebo celého dokumentu.

  • Obsahuje netisknutelných znaků, jako jsou mezery, znaky tabulátoru a značky odstavců.

  • Může to být oblast reprezentovaná aktuálním výběrem nebo může představovat oblast odlišnou od aktuálního výběru.

  • Není vidět v dokumentu, na rozdíl od výběru, který je vždy viditelný.

  • Není uložen s dokumentem a existuje pouze v době, kdy je kód spuštěný.

    Když vložíte text na konec oblasti, Word automaticky rozbalí oblast tak, aby zahrnoval vložený text.

Objekty ovládacího prvku obsahu

A ContentControl nabízí způsob, jak řídit zadávání a prezentaci textu a dalších typů obsahu ve wordových dokumentech. A ContentControl může zobrazit několik různých typů uživatelského rozhraní, které jsou optimalizované pro použití ve wordových dokumentech, jako je ovládací prvek rtf, výběr data nebo pole se seznamem. Můžete také použít ContentControl možnost zabránit uživatelům v úpravách oddílů dokumentu nebo šablony.

Visual Studio rozšiřuje ContentControl objekt do několika různých hostitelských ovládacích prvků. ContentControl Zatímco objekt může zobrazit libovolný z různých typů uživatelského rozhraní, které jsou k dispozici pro ovládací prvky obsahu, Sada Visual Studio poskytuje pro každý ovládací prvek obsahu jiný typ. Můžete například použít RichTextContentControl ovládací prvek pro formátování textu nebo můžete použít DatePickerContentControl k vytvoření výběru data. Tyto hostitelské ovládací prvky se chovají jako nativní ContentControl, ale mají další události a možnosti vazby dat. Další informace naleznete v tématu Ovládací prvky obsahu.

Objekt záložky

Objekt Bookmark představuje souvislou oblast v dokumentu s počáteční i koncovou pozicí. Záložky můžete použít k označení umístění v dokumentu nebo jako kontejner pro text v dokumentu. Objekt Bookmark se může skládat z kurzoru nebo může být velký jako celý dokument. A Bookmark má následující vlastnosti, které ho od objektu nastavily Range :

  • Záložku můžete pojmenovat v době návrhu.

  • Bookmark objekty jsou uloženy s dokumentem, a proto nejsou odstraněny, když kód přestane běžet nebo je dokument zavřený.

  • Záložky mohou být skryté nebo viditelné nastavením ShowBookmarks vlastnosti objektu View na false nebo true.

    Visual Studio rozšiřuje Bookmark objekt poskytnutím Bookmark ovládacího prvku hostitele. Hostitelský Bookmark ovládací prvek se chová jako nativní Bookmark, ale má další události a možnosti datové vazby. Data můžete svázat s ovládacím prvku záložky v dokumentu stejným způsobem jako data s ovládacím prvku textového pole ve Formuláři Windows. Další informace naleznete v tématu Záložka ovládací prvek.

Použití dokumentace k objektovém modelu Wordu

Úplné informace o objektovém modelu aplikace Word naleznete v odkazu na primární sestavení interop aplikace Word (PIA) a odkaz na objektový model jazyk Visual Basic for Application (VBA).

Referenční dokumentace primárního sestavení vzájemné spolupráce

Referenční dokumentace k sadě Word PIA popisuje typy v primárním sestavení vzájemné spolupráce pro Word. Tato dokumentace je k dispozici z následujícího umístění: Referenční informace k sestavení primární komunikace aplikace Word 2010.

Další informace o návrhu wordové PIA, jako jsou rozdíly mezi třídami a rozhraními v PIA a o tom, jak jsou implementované události v PIA, naleznete v tématu Přehled tříd a rozhraní v primárních sestaveních vzájemné spolupráce Office.

Referenční dokumentace k objektového modelu jazyka VBA

Referenční model objektu VBA dokumentuje objektový model Wordu, protože je vystaven kódu jazyka VBA. Další informace najdete v referenčních informacích k objektového modelu Wordu 2010.

Všechny objekty a členy v odkazu na objektový model VBA odpovídají typům a členům ve Word PIA. Například objekt Document v odkazu na objektový model jazyka VBA odpovídá Document objektu ve Word PIA. I když odkaz na objektový model jazyka VBA poskytuje příklady kódu pro většinu vlastností, metod a událostí, musíte kód jazyka VBA v tomto odkazu přeložit do jazyka Visual Basic nebo Visual C#, pokud je chcete použít ve wordovém projektu, který vytvoříte pomocí sady Visual Studio.

Související obsah