Sdílet prostřednictvím

Návod: Vytvoření prvního doplňku VSTO pro Word

  • Článek

V tomto úvodním návodu se dozvíte, jak vytvořit doplněk VSTO pro systém Microsoft Office Wordu. Funkce, které vytvoříte v tomto druhu řešení, jsou k dispozici pro samotnou aplikaci bez ohledu na to, které dokumenty jsou otevřené.

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

Tento návod znázorňuje následující úlohy:

  • Vytvoření projektu doplňku Word VSTO

  • Psaní kódu, který používá objektový model Wordu k přidání textu do dokumentu při uložení

  • Sestavení a spuštění projektu, který ho otestuje.

  • Vyčištění dokončeného projektu tak, aby se doplněk VSTO přestal automaticky spouštět na vývojovém počítači.

    Poznámka:

    Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

Vytvoření projektu

Vytvoření nového projektu doplňku Word VSTO v sadě Visual Studio

  1. Spusťte Visual Studio.

  2. V nabídce Soubor přejděte na příkaz Nový a klepněte na tlačítko Projekt.

  3. V podokně šablon rozbalte Visual C# nebo Visual Basic a potom rozbalte Office/SharePoint.

  4. V rozbaleném uzlu Office nebo SharePointu vyberte uzel Doplňky Pro Office.

  5. V seznamušablonch

  6. Do pole Název zadejte FirstWordAddIn.

  7. Klikněte na OK.

    Visual Studio vytvoří projekt FirstWordAddIn a otevře soubor kódu ThisAddIn v editoru.

Napsání kódu pro přidání textu do uloženého dokumentu

Dále přidejte kód do souboru kódu ThisAddIn. Nový kód používá objektový model Wordu k přidání často používaného textu do každého uloženého dokumentu. Ve výchozím nastavení soubor kódu ThisAddIn obsahuje následující vygenerovaný kód:

  • Částečná definice ThisAddIn třídy. Tato třída poskytuje vstupní bod pro váš kód a poskytuje přístup k objektovému modelu Wordu. Další informace naleznete v tématu Program VSTO Doplňky. Zbývající část ThisAddIn třídy je definována ve skrytém souboru kódu, který byste neměli upravovat.

  • Obslužné ThisAddIn_Startup rutiny událostí a ThisAddIn_Shutdown obslužné rutiny událostí. Tyto obslužné rutiny událostí se volají, když Word načte a uvolní doplněk VSTO. Pomocí těchto obslužných rutin událostí inicializujete doplněk VSTO při jeho načtení a vyčistíte prostředky používané doplňkem VSTO při jeho uvolnění. Další informace naleznete v tématu Události v projektech Office.

Přidání odstavce textu do uloženého dokumentu

  1. Do souboru kódu ThisAddIn přidejte do ThisAddIn třídy následující kód. Nový kód definuje obslužnou rutinu DocumentBeforeSave události pro událost, která se vyvolá při uložení dokumentu.

    Když uživatel uloží dokument, obslužná rutina události přidá na začátek dokumentu nový text.

    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á indexovou hodnotu 1 pro přístup k prvnímu odstavci v kolekci Paragraphs . I když Visual Basic a Visual C# používají 0 polí, dolní maticové hranice většiny kolekcí v objektovém modelu Wordu jsou 1. Další informace najdete v tématu Psaní kódu v řešeních Office.

  2. Pokud používáte jazyk C#, přidejte do ThisAddIn_Startup obslužné rutiny události následující požadovaný kód. Tento kód slouží k připojení Application_DocumentBeforeSave obslužné rutiny DocumentBeforeSave události k události.

    this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);

    Pokud chcete upravit dokument při uložení, předchozí příklady kódu používají následující objekty:

  • Pole Application ThisAddIn třídy. Pole Application vrátí Application objekt, který představuje aktuální instanci aplikace Word.

  • Parametr Doc obslužné rutiny události pro DocumentBeforeSave událost. Parametr Doc je Document objekt, který představuje uložený dokument. Další informace naleznete v tématu Přehled objektového modelu aplikace Word.

Testování projektu

Otestování projektu

  1. Stisknutím klávesy F5 sestavte a spusťte projekt.

    Při sestavení projektu se kód zkompiluje do sestavení, které je součástí výstupní složky sestavení projektu. Visual Studio také vytvoří sadu položek registru, které wordu umožňují vyhledat a načíst doplněk VSTO, a nakonfiguruje nastavení zabezpečení na vývojovém počítači tak, aby bylo možné doplněk VSTO spustit. Další informace najdete v tématu Sestavení řešení Office.

  2. Ve Wordu uložte aktivní dokument.

  3. Ověřte, že do dokumentu je přidaný následující text.

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

  4. Zavřete Word.

Vyčištění projektu

Po dokončení vývoje projektu odeberte z vývojového počítače sestavení doplňku VSTO, položky registru a nastavení zabezpečení. Jinak se doplněk VSTO bude dál spouštět při každém otevření Wordu na vývojovém počítači.

Vyčištění dokončeného projektu na vývojovém počítači

  1. V sadě Visual Studio v nabídce Sestavení klepněte na tlačítko Vyčistit řešení.

Další kroky

Teď, když jste vytvořili základní doplněk VSTO pro Word, můžete se dozvědět více o tom, jak vyvíjet doplňky VSTO z těchto témat:

  • Obecné programovací úlohy, které můžete provádět v doplňkech VSTO: Programové doplňky VSTO.

  • Programovací úlohy, které jsou specifické pro doplňky VSTO aplikace Word: Řešení aplikace Word.

  • Použití objektového modelu Wordu: Přehled objektového modelu Wordu

  • Přizpůsobení uživatelského rozhraní Wordu, například přidáním vlastní karty na pás karet nebo vytvořením vlastního podokna úloh: Přizpůsobení uživatelského rozhraní Office

  • Vytváření a ladění doplňků VSTO pro Word: Vytváření řešení Office

  • Nasazení doplňků VSTO pro Word: Nasazení řešení Office

Související obsah