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

  • Č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 Excelu. Funkce, které vytvoříte v tomto typu řešení, jsou k dispozici pouze v případě, že je otevřený konkrétní sešit. Přizpůsobení na úrovni dokumentu nelze použít k provádění změn na úrovni aplikace, například zobrazení nové karty pásu karet při otevření libovolného sešitu.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu pro Excel. 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 excelového sešitu

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

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

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

  • Vyčištěním dokončeného 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 excelového sešitu 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 sešitu aplikace Excel 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 FirstWorkbookCustomization a přidá do projektu následující soubory.

    • FirstWorkbookCustomization.xlsx – představuje excelový sešit v projektu. Obsahuje všechny listy a grafy.

    • List1 (soubor .vb pro soubor Visual Basic nebo .cs pro Visual C#) – list, který poskytuje návrhovou plochu a kód prvního listu v sešitu. Další informace naleznete v tématu Položka hostitele listu.

    • List2 (soubor .vb pro soubor Visual Basic nebo .cs pro Visual C#) – list, který poskytuje návrhovou plochu a kód druhého listu v sešitu.

    • Sheet3 (soubor .vb pro soubor Visual Basic nebo .cs pro Visual C#) – list, který poskytuje návrhovou plochu a kód třetího listu v sešitu.

    • ThisWorkbook (soubor .vb pro soubor Visual Basic nebo .cs pro Visual C#) – obsahuje návrhovou plochu a kód pro přizpůsobení na úrovni sešitu. Další informace naleznete v tématu Položku hostitele sešitu.

      Soubor s kódem Sheet1 se automaticky otevře v návrháři.

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

Pokud při vývoji projektu záměrně nebo omylem zavřete sešit nebo list v návrháři, můžete ho znovu otevřít.

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

  1. Zavřete sešit 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 List1 a klikněte na Návrhář zobrazení.

    - nebo -

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

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

Uživatelské rozhraní vlastního nastavení můžete navrhnout úpravou listu, který je otevřený v návrháři. Můžete například přidat text do buněk, použít vzorce nebo přidat ovládací prvky Aplikace Excel. 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 listu pomocí návrháře

  1. V listu, který je otevřen v návrháři, vyberte buňku A1 a zadejte následující text.

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

Upozorňující

Pokud tento řádek textu přidáte do buňky A2, přepíše se jiným kódem v tomto příkladu.

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

Dále přidejte kód do souboru s kódem Sheet1. Nový kód používá objektový model Aplikace Excel k přidání druhého řádku textu do sešitu. Ve výchozím nastavení soubor kódu Sheet1 obsahuje následující vygenerovaný kód:

  • Částečná definice Sheet1 třídy, která představuje programovací model listu a poskytuje přístup k objektového modelu aplikace Excel. Další informace získáte v přehledu položky hostitele listu a objektového modelu aplikace Word. Zbývající část Sheet1 třídy je definována ve skrytém souboru kódu, který byste neměli upravovat.

  • Obslužné Sheet1_Startup rutiny událostí a Sheet1_Shutdown obslužné rutiny událostí. Tyto obslužné rutiny událostí se volají, když Excel načte a uvolní vaše vlastní nastavení. Pomocí těchto obslužných rutin událostí můžete inicializovat vlastní nastavení při jeho načtení a vyčistit prostředky používané při jeho uvolnění. Další informace naleznete v tématu Události v projektech Office.

Přidání druhého řádku textu do listu pomocí kódu

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

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

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

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testování projektu

Otestování sešitu

  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 sešitu. Visual Studio umístí kopii sešitu 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 sešitu 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 sešit.

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 Excel, 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 Excel: řešení Excelu.

  • Použití objektového modelu Aplikace Excel: Přehled objektového modelu aplikace Excel.

  • Přizpůsobení uživatelského rozhraní Excelu, 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 excelových objektů poskytovaných vývojářskými nástroji Office v sadě Visual Studio k provádění úloh, které nejsou možné pomocí objektového modelu Excelu (například hostování spravovaných ovládacích prvků na dokumentech a vytváření vazeb ovládacích prvků Excelu k datům pomocí modelu datové vazby model Windows Forms): Automatizujte Excel pomocí rozšířených objektů.

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

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

Související obsah