Návod: Vytvoření prvního přizpůsobení na úrovni dokumentu pro Word
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:
Edice Visual Studia, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace najdete v tématu Konfigurace počítače pro vývoj řešení Office.
Microsoft Word
Vytvoření projektu
Vytvoření nového projektu wordového dokumentu v sadě Visual Studio
Spusťte Visual Studio.
V nabídce Soubor přejděte na příkaz Nový a klepněte na tlačítko Projekt.
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.
Klikněte na tlačítko Další.
Do pole Název v dialogovém okně Konfigurovat nový projekt zadejte FirstWorkbookCustomization a klikněte na Vytvořit.
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
Zavřete dokument kliknutím na tlačítko Zavřít (X) pro okno návrháře.
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
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í částThisDocument
třídy je definována ve skrytém souboru kódu, který byste neměli upravovat.Obslužné
ThisDocument_Startup
rutiny událostí aThisDocument_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
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.
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
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.
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.
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
- 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
- Přehled vývoje řešení pro Office (VSTO)
- Řešení wordových aplikací
- Přizpůsobení na úrovni dokumentu programu
- Přehled objektového modelu Wordu
- Automatizace Wordu pomocí rozšířených objektů
- Přizpůsobení uživatelského rozhraní Office
- Vytváření řešení Pro systém Office
- Nasazení řešení Office
- Přehled šablon projektů Office