Návod: Vytvoření prvního přizpůsobení na úrovni dokumentu pro Word

Článek
05/16/2015

Tento úvodní návod ukazuje, jak vytvořit vlastní úroveň dokument pro aplikaci Microsoft Office Word.Funkce, které vytvoříte v řešení tohoto typu jsou k dispozici pouze při otevření určitého dokumentu.Nelze použít úroveň dokument přizpůsobení změny celou aplikaci, například při otevření jakéhokoli dokumentu zobrazení novou kartu pásu karet.

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

Tento návod ilustruje následující úkoly:

Vytvoření projektu dokument aplikace Word.
Přidání textu do dokumentu, který je hostitelem v návrháři Visual Studio.
Psaní kódu, který používá model objektu aplikace Word přidat text upravený dokument, když je otevřen.
Vytvoření a spuštění projektu pro.
Čištění projektu z vývojového počítače odebrat sestavení nepotřebné soubory a nastavení zabezpečení.

[!POZNÁMKA]

Na vašem počítači se můžou v následujících pokynech zobrazovat jiné názvy nebo umístění některých prvků uživatelského rozhraní Visual Studia. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace najdete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

Edice Visual Studia 2013, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace najdete v tématu Konfigurace počítače pro vývoj řešení pro systém Office.
Word 2013 nebo Word 2010.

Vytváření projektu

V aplikaci Visual Studio vytvořte nový projekt dokumentu aplikace Word

Spusťte nástroj Visual Studio.
V nabídce File (Soubor) přejděte na příkaz New (Nový) a klepněte na příkaz Project (Projekt).
Rozbalte v podokně šablony Visual C# nebo jazyka Visual Basica potom rozbalte Office/SharePoint.
V rámci rozšířeného Office/SharePoint uzel, vyberte Doplňky sady Office uzlu.
Vyberte v seznamu šablon projektu Dokument aplikace Word 2010 nebo 2013 dokumentu aplikace Word.
V název zadejte FirstDocumentCustomization.
Klikněte na tlačítko OK.

Visual Studio Tools for Office Project Průvodce otevře.
Vyberte vytvořit nový dokumenta na OK.

Visual Studiovytvoří FirstDocumentCustomization projektu a přidá FirstDocumentCustomization dokumentu a ThisDocument kód souboru projektu.FirstDocumentCustomization dokumentu automaticky otevřen v návrháři.

Zavřete a znovu otevřete dokument v Návrháři

Pokud úmyslně nebo neúmyslně zavřete dokument v Návrháři při vývoji projektu, můžete jej znovu otevřít.

Zavřete a znovu otevřete dokument v Návrháři

Dokument zavřete klepnutím Zavřít tlačítko (X) v okně návrháře.
V Průzkumníku, klepněte pravým tlačítkem myši ThisDocument kód souboru a klepněte na Návrhář zobrazení.

-nebo-

V Průzkumníku, poklepejte ThisDocument soubor kódu.

Přidání textu do dokumentu v Návrháři

Úprava dokumentu, který je otevřen v návrháři, můžete navrhnout uživatelské rozhraní (UI) vašeho vlastního nastavení.Můžete například přidat text, tabulky nebo ovládací prvky aplikace Word.Další informace o použití návrháře viz Projekty pro systém Office v prostředí Visual Studio.

Chcete-li přidat text do dokumentu pomocí návrháře

V dokumentu, který je otevřen v Návrháři zadejte následující text.

Tento text byl přidán pomocí návrháře.

Programové přidání textu do dokumentu

Dále přidejte kód do souboru kódu ThisDocument.Nový kód používá model objektu aplikace Word přidat druhý odstavec textu v dokumentu.Ve výchozím nastavení obsahuje následující kód generovaný soubor ThisDocument kódu:

Částečnou definici ThisDocument třídy, která představuje programovací model dokumentu a poskytuje přístup k objektovému modelu aplikace Word.Další informace naleznete v tématu Hostitelská položka Document a Přehled modelu objektů aplikace Word.Zbytek ThisDocument třída je definována v souboru skrytý kód, který byste neměli měnit.
ThisDocument_Startup a ThisDocument_Shutdown obslužné rutiny událostí.Tyto obslužné rutiny událostí jsou volána, když je dokument otevřít a zavřít.Tyto obslužné rutiny událostí pomocí vlastní inicializace, při otevření dokumentu a k vyčištění prostředků používaných vlastní při zavření dokumentu.Další informace naleznete v tématu Události v projektech pro systém Office.

Přidání druhého odstavce textu do dokumentu pomocí kódu

V Průzkumníku, klepněte pravým tlačítkem ThisDocumenta klepněte na tlačítko Zobrazení kódu.

V aplikaci Visual Studio otevře soubor kódu.
Nahradit ThisDocument_Startup obslužnou rutinu následujícím kódem.Při otevření dokumentu tento kód přidá druhý odstavec textu v dokumentu.
```
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code." 
End Sub
```
```
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}
```
[!POZNÁMKA]

Tento kód používá hodnotu indexu 1 přístup v prvním odstavci Paragraphs vlastnost.Přestože Visual Basic a Visual C# pomocí matice založené na 0, dolní hranice většina kolekce v objektovém modelu aplikace Word pole je 1.Další informace naleznete v tématu Psaní kódu v řešeních pro systém Office.

Testování projektu

Testování dokumentu

Stiskněte klávesu F5 k vytvoření a spuštění projektu.

Při sestavení projektu kód je zkompilován do sestavení, které je přidružené k dokumentu.Výstupní složku sestavení pro projekt Visual Studio vloží kopii dokumentu a sestavení a nakonfiguruje nastavení zabezpečení na vývojovém počítači povolit vlastní nastavení spuštění.Další informace naleznete v tématu Sestavování řešení pro systém Office.
V dokumentu zkontrolujte naleznete v následujícím textu.

Tento text byl přidán pomocí návrháře.

Tento text byl přidán pomocí kódu.
Zavřete dokument.

Čištění projektu

Po dokončení vývoje projektu byste měli odebrat soubory výstupní složku sestavení a nastavení zabezpečení vytvořené v procesu sestavení.

Vyčistit dokončeného projektu na vývojovém počítači

V aplikaci Visual Studio na sestavení nabídky, klepněte na Čisté řešení.

Další kroky

Nyní, když jste vytvořili základní úroveň dokumentu aplikace Word, můžete dozvědět více o vývoji vlastního nastavení z těchto témat:

Obecné programovací úkoly, které můžete provádět úpravy na úrovni dokumentu: Programování přizpůsobení na úrovni dokumentu.
Programovací úlohy, které jsou specifické pro vlastní úroveň dokumentu aplikace Word: Řešení pro Word.
Použití objektového modelu aplikace Word: Přehled modelu objektů aplikace Word.
Přizpůsobení uživatelského rozhraní aplikace Word, například pomocí přidání vlastní kartu na pásu karet nebo vytvořením vlastní akce podokno: Přizpůsobení uživatelského rozhraní systému Office.
Pomocí rozšířené objekty Word Office řešení v sadě Visual Studio provádět úkoly, které nejsou možné pomocí objektového modelu aplikace Word (například hostování spravovaných ovládacích prvků na dokumenty a Word ovládací prvky vázání na data pomocí model vázání dat model Windows Forms): Automatizace v aplikaci Word s použitím rozšířených objektů.
Vytváření a ladění přizpůsobení úroveň dokument Word: Sestavování řešení pro systém Office.
Nasazení vlastní úroveň dokumentu aplikace Word: Nasazení řešení Office.