Přehled modelu objektů aplikace Word

Článek
05/16/2015

Při vývoji řešení aplikace Word v aplikaci Visual Studio spolupracovat s objektového modelu aplikace Word.Tento objektový model se skládá z tříd a rozhraní, které jsou uvedeny v primární sestavení interop pro aplikaci Word a jsou definovány v Microsoft.Office.Interop.Word oboru názvů.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace ve Wordu 2013 a ve Wordu 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Toto téma obsahuje stručný přehled objektového modelu aplikace Word.Zdroje, kde můžete získat další informace o objektovém modelu celé slovo, viz dokumentaci Model objektu aplikace Word pomocí.

Informace o použití objektového modelu aplikace Word k provádění specifických úloh naleznete v následujících tématech:

Principy objektového modelu aplikace Word

Aplikace Word nabízí stovky objektů, se kterými spolupracují.Tyto objekty jsou uspořádány v hierarchii následuje úzce uživatelského rozhraní.V horní části hierarchie je Application objektu.Tento objekt představuje aktuální instance aplikace Word.The Application object contains the Document, Selection, Bookmark, and Range objects.Každý z těchto objektů má mnoho metod a vlastností, které lze pracovat a manipulovat s objektem.

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

Abstraktní Model objektu aplikace Word

Grafika objektový Model aplikace Word

Na první pohled se objekty překrývají.Například Document a Selection objekty jsou oba členy Application objektu, ale Document objektu je také členem Selection objektu.Jak Document a Selection objekty obsahují Bookmark a Range objektů.Překrytí existuje, protože přístup stejný typ objektu více způsoby.Například použijete formátování Range objektu; ale chcete přistupovat oblast aktuálního výběru, zejména odstavce, části nebo celého dokumentu.

Následující oddíly stručně popište nejvyšší úrovně objektů a jejich interakce s sebou.Mezi tyto objekty patří následujících pět:

Aplikační objekt
Objekt dokumentu
Výběr objektu
Rozsah objektu
Záložka objektu

Kromě objektového modelu aplikace Word Office projekty v aplikaci Visual Studio poskytnout hostitel položky a hostitel prvky , rozšířit některé objekty v objektovém modelu aplikace Word.Položky hostitele a hostitele ovládací prvky chovají jako objekty aplikace Word, které rozšiřují, ale mají také další funkce, jako jsou například možnosti vázání dat a zvláštní události.Další informace naleznete v tématu Automatizace v aplikaci Word s použitím rozšířených objektů a Přehled hostitelských položek a hostitelských ovládacích prvků.

Aplikační objekt

Application Objekt představuje aplikaci Word a je rodičem všech ostatních objektů.Jeho členové obvykle vztahuje na slovo jako celek.Jeho vlastnosti a metody slouží k řízení prostředí aplikace Word.

Na úrovni aplikace přidat v projektech přístup Application pomocí objektu Application pole ThisAddIn třídy.Další informace naleznete v tématu Programování doplňků na úrovni aplikace.

V projektech na úrovni dokumentu, přístup Application pomocí objektu Application vlastnost ThisDocument třídy.

Objekt dokumentu

Document Objektu je programovací aplikace Word.Představuje dokument a jeho obsahu.Při otevření dokumentu nebo vytvořit nový dokument, vytvořte novou Document objektu, který je přidán do Documents kolekce Application objektu.Dokument, který má fokus, se nazývá aktivní dokument.Je zastoupena ActiveDocument vlastnost Application objektu.

Vývojové nástroje sady Office v aplikaci Visual Studio rozšířit Document objektu poskytnutím Document typu.Tento typ je položku hostitele , poskytuje přístup ke všem funkcím Document objektu a přidá další události a možnost přidat spravovaný ovládací prvky.

Při vytváření projektu úrovni dokumentu přístup Document členy pomocí vytvořené ThisDocument třídy v projektu.Přístup členové Document položku hostitele pomocí Me nebo this klíčových slov v kódu ThisDocument třídy nebo pomocí Globals.ThisDocument z kódu mimo ThisDocument třídy.Další informace naleznete v tématu Programování přizpůsobení na úrovni dokumentu.Například chcete-li vybrat první odstavec v dokumentu, použijte následující kód.

Me.Paragraphs(1).Range.Select()

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

Na úrovni aplikace projektech, generovat Document hostitel položek v době spuštění.Můžete přidat ovládací prvky související dokument položky generované hostitele.Další informace naleznete v tématu Rozšíření dokumentů aplikace Word a sešitů aplikace Excel v doplňcích na úrovni aplikace za běhu.

Výběr objektu

Selection Objekt představuje oblast, která je aktuálně vybrána.Při provádění operace v uživatelském rozhraní aplikace Word, například tučné, vybrat, nebo zvýrazněte text a pak použít formátování.Selection Objekt je vždy v dokumentu.Pokud není nic vybráno, pak představuje kurzor.Kromě toho výběr zahrnovat více bloků textu, které není souvislé.

Rozsah objektu

Range Objekt představuje souvislé oblasti v dokumentu a definuje počáteční pozice znaku a koncové pozice znaku.Nejste omezeni na jedinou Range objektu.Můžete definovat více Range objekty ve stejném dokumentu.A Range objektu má následující charakteristiky:

Můžete se skládají pouze kurzor, rozsah textu nebo celý dokument.
Obsahuje netisknutelné znaky jako mezery, tabulátory a konce odstavce.
Může být zastoupen aktuální výběr oblasti nebo může představovat oblast, která se liší od aktuálního výběru.
Není viditelný v dokumentu, na rozdíl od výběru je vždy zobrazen.
Dokument není uložen a existuje pouze kód je spuštěn.

Při vložení textu na konci rozsahu aplikace Word automaticky rozbalí oblasti zahrnout vložený text.

Objekty obsahu ovládacího prvku

A ContentControl umožňuje řídit vstup a úprava textu a jiných typů obsahu v dokumentech aplikace Word.A ContentControl můžete zobrazit několik různých typů uživatelského rozhraní, která jsou optimalizována pro použití v dokumentech aplikace Word, například ovládacího prvku s formátovaným textem, výběr data nebo pole se seznamem.Můžete také použít ContentControl zabránit uživatelům v úpravách oddíly dokumentu nebo šablony.

Visual Studio rozšiřuje ContentControl objektu do několika prvků jiného hostitele.Vzhledem ContentControl objektu můžete zobrazit všechny různé typy uživatelského rozhraní, které jsou k dispozici pro ovládací prvky obsahu, Visual Studio obsahuje pro každý ovládací prvek jiného typu.Můžete například použít RichTextContentControl můžete použít k vytvoření ovládacího prvku s formátovaným textem, nebo DatePickerContentControl vytvořte ovládací prvek Výběr data.Tyto ovládací prvky hostitele chovat jako nativním ContentControl, ale mají další události a možností vázání dat.Další informace naleznete v tématu Ovládací prvky obsahu.

Záložka objektu

Bookmark Objekt představuje souvislé oblasti v dokumentu s počáteční pozice a koncovou pozici.Záložky můžete použít k označení umístění v dokumentu nebo jako kontejner pro text v dokumentu.A Bookmark objektu lze skládat z kurzor nebo být stejně velká jako celý dokument.A Bookmark má následující vlastnosti, které jej kromě Range objekt:

Zadáte-li název záložky v době návrhu.
Bookmarkobjekty se ukládají s dokumentem a tedy nejsou odstraněny při kódu nebo zavření dokumentu.
Záložky můžete skryté nebo nastavením zviditelnit ShowBookmarks vlastnost View objekt na false nebo true.

Visual Studio rozšiřuje Bookmark objektu poskytnutím Bookmark hostiteli ovládacího prvku.Bookmark Hostiteli ovládacího prvku se chová jako nativním Bookmark, ale má další události a možností vázání dat.Data můžete svázat ovládací prvek záložky v dokumentu stejným způsobem vázání dat pro ovládací prvek textové pole formuláře systému Windows.Další informace naleznete v tématu Záložka – ovládací prvek.

Pomocí dokumentace Model objektu aplikace Word

Úplné informace o objektovém modelu aplikace Word může odkazovat na referenční primární sestavení interop (PIA) aplikace Word a Visual Basic for Applications (VBA) objektu modelu odkaz.

Primární Interop odkaz na sestavení

Moduly PIA aplikace Word referenční dokumentace popisuje typy v primární sestavení interop pro aplikaci Word.Tato dokumentace je k dispozici v následujícím umístění: 2010 slovo, primární odkaz sestavení Interop.

Další informace o návrhu PIA aplikace Word, například rozdíly mezi třídy a rozhraní v primární a způsob implementace událostí v primární Přehled tříd a rozhraní v primární sestavení Interop Office.

Odkaz na Model objektu jazyka VBA

Odkaz na model objektu jazyka VBA dokumentů objektového modelu aplikace Word, jako je vystaven kódu jazyka VBA.Další informace naleznete v Odkaz na Model objektu aplikace Word 2010.

Všechny objekty a členy v referenční model objektu jazyka VBA odpovídat typy a členové PIA aplikace Word.Například Document objekt v referenční model objektu jazyka VBA odpovídá Document objektu v aplikaci Word PIA.Sice referenční model objektu jazyka VBA poskytuje příklady kódu pro většinu vlastností, metod a událostí, musíte převést kód VBA v tomto odkazu do jazyka Visual Basic nebo Visual C# Chcete-li použít slovo projektu můžete vytvořit pomocí aplikace Visual Studio.