Názorný postup: Vytvoření první vlastní nastavení úrovni dokumentu aplikace Word

Článek
03/04/2013

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 v aplikacích Word 2013 a Word 2010. Další informace naleznete v tématu Funkce aplikace 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]

Ve vašem počítači se pro některé z prvků uživatelského rozhraní sady Visual Studio mohou zobrazit jiné názvy a umístění, než jsou uvedeny v následujících pokynech. Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením. Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Požadavky

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

Edice sady Visual Studio 2012, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace naleznete v tématu [Konfigurace počítače vyvinout řešení Office](bb398242\(v=vs.110\).md).

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 Office projekty 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 Položku hostitele dokumentu a Přehled modelu objektu 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 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í 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 Vytváření řešení sady 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: Úpravy dokumentu úroveň programování.
Programovací úlohy, které jsou specifické pro vlastní úroveň dokumentu aplikace Word: Řešení aplikace Word.
Použití objektového modelu aplikace Word: Přehled modelu objektu 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í sady 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 aplikace Word pomocí rozšířené objekty.
Vytváření a ladění přizpůsobení úroveň dokument Word: Vytváření řešení sady Office.
Nasazení vlastní úroveň dokumentu aplikace Word: Nasazení řešení Office.