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

  • Článek

V tomto úvodním návodu se dozvíte, jak vytvořit přizpůsobení na úrovni dokumentu pro systém Microsoft Office Wordu. Funkce, které vytvoříte v tomto typu řešení, jsou dostupné jenom v případě, že je otevřený konkrétní dokument. Přizpůsobení na úrovni dokumentu nelze použít k provádění změn v celé aplikaci, například zobrazení nové karty pásu karet při otevření libovolného dokumentu.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu 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 wordového dokumentu

  • Přidání textu do dokumentu hostovaného v návrháři sady Visual Studio

  • Psaní kódu, který používá objektový model Wordu k přidání textu do přizpůsobeného dokumentu při otevření

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

  • Vyčištěním projektu odeberete nepotřebné soubory sestavení a nastavení zabezpečení z vývojového počítače.

    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 wordového dokumentu 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 dialogovém okně Vytvořit nový projekt vyberte projekt dokumentu aplikace Word VSTO.

    Poznámka:

    Šablony můžete také vyhledat zadáním názvu produktu Office do textového pole Hledat v horní části dialogového okna Vytvořit nový projekt . Když třeba napíšete Excel , zobrazí se vám všechny šablony projektů pro Excel. Seznam šablon můžete také filtrovat tak, aby se zobrazovaly jenom šablony pro Office, a to tak , že v rozevíracím seznamu Typ projektu vyberete Office . Další informace naleznete v tématu Vytvoření nového projektu v sadě Visual Studio.

  4. Klikněte na tlačítko Další.

  5. Do pole Název v dialogovém okně Konfigurovat nový projekt zadejte FirstWorkbookCustomization a klikněte na Vytvořit.

  6. V Průvodci visual studio tools for Office Project vyberte Vytvořit nový dokument a klikněte na OK.

    • Visual Studio vytvoří projekt FirstDocumentCustomization a přidá do projektu dokument FirstDocumentCustomization a soubor kódu ThisDocument. Dokument FirstDocumentCustomization se automaticky otevře v návrháři.

Zavření a opětovné otevření dokumentu v návrháři

Pokud během vývoje projektu záměrně nebo omylem zavřete dokument v návrháři, můžete ho znovu otevřít.

Zavření a opětovné otevření dokumentu v návrháři

  1. Zavřete dokument kliknutím na tlačítko Zavřít (X) pro okno návrháře.

  2. V Průzkumník řešení klikněte pravým tlačítkem myši na soubor s kódem ThisDocument a klepněte na příkaz Návrhář zobrazení.

    - nebo -

    V Průzkumník řešení poklikejte na soubor s kódem ThisDocument.

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

Uživatelské rozhraní vlastního nastavení můžete navrhnout úpravou dokumentu, který je otevřený v návrháři. Můžete například přidat text, tabulky nebo ovládací prvky Wordu. Další informace o tom, jak používat návrháře, najdete v tématu Projekty Office v prostředí sady Visual Studio.

Přidání textu do dokumentu pomocí návrháře

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

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

Přidání textu do dokumentu prostřednictvím kódu programu

Dále přidejte kód do souboru s kódem ThisDocument. Nový kód používá objektový model Wordu k přidání druhého odstavce textu do dokumentu. Ve výchozím nastavení soubor kódu ThisDocument obsahuje následující vygenerovaný kód:

  • Částečná definice ThisDocument třídy, která představuje programovací model dokumentu a poskytuje přístup k objektového modelu aplikace Word. Další informace najdete v tématu Přehled položky hostitele dokumentu a objektového modelu Aplikace Word. Zbývající část ThisDocument třídy je definována ve skrytém souboru kódu, který byste neměli upravovat.

  • Obslužné ThisDocument_Startup rutiny událostí a ThisDocument_Shutdown obslužné rutiny událostí. Tyto obslužné rutiny událostí se volají při otevření a zavření dokumentu. Pomocí těchto obslužných rutin událostí inicializujete vlastní nastavení při otevření dokumentu a vyčistíte prostředky používané 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

  1. V Průzkumník řešení klepněte pravým tlačítkem myši ThisDocument a potom klepněte na tlačítko Zobrazit kód.

    Soubor kódu se otevře v sadě Visual Studio.

  2. Obslužnou rutinu ThisDocument_Startup události nahraďte následujícím kódem. Při otevření dokumentu tento kód přidá do dokumentu druhý odstavec textu.

    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 pro přístup k prvnímu Paragraphs odstavci ve vlastnosti. 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.

Testování projektu

Otestování dokumentu

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

    Při sestavení projektu se kód zkompiluje do sestavení, které je přidružené k dokumentu. Visual Studio umístí kopii dokumentu a sestavení do výstupní složky sestavení projektu a nakonfiguruje nastavení zabezpečení na vývojovém počítači, aby bylo možné provést vlastní nastavení. Další informace najdete v tématu Sestavení řešení Office.

  2. V dokumentu ověřte, že se zobrazí následující text.

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

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

  3. Zavřete dokument.

Vyčištění projektu

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

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í přizpůsobení na úrovni dokumentu pro Word, můžete se dozvědět více o tom, jak vyvíjet vlastní nastavení z těchto témat:

  • Obecné programovací úlohy, které můžete provádět v přizpůsobeních na úrovni dokumentu: Programovat přizpůsobení na úrovni dokumentu.

  • Programovací úlohy, které jsou specifické pro přizpůsobení na úrovni dokumentu pro Word: řešení Wordu.

  • 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 akcí: Přizpůsobení uživatelského rozhraní Office

  • Použití rozšířených objektů Wordu poskytovaných řešeními Office v sadě Visual Studio k provádění úloh, které nejsou možné pomocí objektového modelu Aplikace Word (například hostování spravovaných ovládacích prvků na dokumentech a vytváření vazeb ovládacích prvků Wordu k datům pomocí modelu datové vazby model Windows Forms): Automatizace Wordu pomocí rozšířených objektů.

  • Vytváření a ladění přizpůsobení na úrovni dokumentu pro Word: Vytváření řešení Office

  • Nasazení přizpůsobení na úrovni dokumentu pro Word: Nasazení řešení Office

Související obsah