Návod: Vytvoření prvního doplňku na úrovni aplikace pro Word

Článek
05/16/2015

Tento úvodní návod ukazuje, jak vytvořit doplněk aplikační úrovni pro aplikaci Microsoft Office Word.Funkce, které vytvoříte v řešení tohoto typu jsou k dispozici samotné bez ohledu na to, které jsou dokumenty aplikace.

Platí pro: Informace v tomto tématu se vztahují na projekty 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.

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

Vytvoření projektu doplňku aplikace Word.
Psaní kódu, který používá model objektu aplikace Word přidat text do dokumentu při ukládání.
Vytvoření a spuštění projektu pro.
Čištění dokončeného projektu tak, aby doplněk již automaticky spustí na vývojovém počítači.

[!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

Vytvořit nové slovo přidat do projektu v aplikaci Visual Studio

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 doplňku aplikace Word 2010 nebo doplňku aplikace Word 2013.
V název zadejte FirstWordAddIn.
Klikněte na tlačítko OK.

Visual Studiovytvoří FirstWordAddIn projektu a otevře soubor ThisAddIn kódu v editoru.

Psaní kódu uloženého dokumentu přidat Text

Dále přidejte kód do souboru kódu ThisAddIn.Nový kód používá model objektu aplikace Word přidat často používaný text každého uloženého dokumentu.Ve výchozím nastavení obsahuje následující kód generovaný kód souboru ThisAddIn:

Částečnou definici ThisAddIn třídy.Tato třída obsahuje vstupní bod pro váš kód a přístup k objektovému modelu aplikace Word.Další informace naleznete v tématu Programování doplňků na úrovni aplikace.Zbytek ThisAddIn třída je definována v souboru skrytý kód, který byste neměli měnit.
ThisAddIn_Startup a ThisAddIn_Shutdown obslužné rutiny událostí.Tyto obslužné rutiny události se nazývají Word načte a uvolní se doplněk.Tyto obslužné rutiny událostí slouží k inicializaci doplňku, která je načtena a k vyčištění prostředků používaných doplněk je uvolněn.Další informace naleznete v tématu Události v projektech pro systém Office.

Přidat odstavec textu uloženého dokumentu

V souboru ThisAddIn, následující kód přidejte ThisAddIn třídy.Nový kód definuje obslužnou rutinu události DocumentBeforeSave událost, která je vyvolána, když je dokument uložen.

Když uživatel uloží dokument, přidá obslužnou rutinu události nový text na začátku dokumentu.
```
Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code." 
End Sub
```
```
void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].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 kolekce.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.
Pokud používáte jazyk C#, přidejte následující kód požadované k ThisAddIn_Startup obslužné rutiny události.Tento kód se používá k připojení Application_DocumentBeforeSave obslužnou rutinu události DocumentBeforeSave události.
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```

Předchozí příklady kódu změnit dokument uložený, použijte následující objekty:

Application Pole ThisAddIn třídy.Application Pole vrátí Application objekt, který představuje aktuální instanci aplikace Word.
Doc Parametr obslužnou rutinu události DocumentBeforeSave události.Doc Parametr je Document objekt, který představuje uloženého dokumentu.Další informace naleznete v tématu Přehled modelu objektů aplikace Word.

Testování projektu

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 součástí výstupní složku sestavení pro projekt.Nastavení položky registru, které umožňují zjišťovat a načíst doplněk aplikace Word vytvoří aplikace Visual Studio a nakonfiguruje nastavení zabezpečení na vývojovém počítači povolit doplněk spustit.Další informace naleznete v tématu Sestavování řešení pro systém Office.
V aplikaci Word uložte aktivní dokument.
Ověřte, že následující text do dokumentu.

Tento text byl přidán pomocí kódu.
Ukončete aplikaci Word.

Čištění projektu

Po dokončení vývoje projektu odeberte z vývojového počítače přidat v sestavení, položky registru a nastavení zabezpečení.Jinak doplněk bude nadále spuštěna při každém otevření aplikace Word na vývojovém počítači.

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í doplněk aplikace Word, můžete se dozvědět více o vývoji doplňků z těchto témat:

Obecné programovací úkoly, které lze provést v doplňky: Programování doplňků na úrovni aplikace.
Programovací úlohy, které jsou specifické pro doplňky 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í vlastní vlastní podokno úloh: Přizpůsobení uživatelského rozhraní systému Office.
Vytváření a ladění doplňků aplikace Word: Sestavování řešení pro systém Office.
Zavedení doplňků aplikace Word: Nasazení řešení Office.