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

Článek
05/16/2015

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

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v Excelu 2013 a v Excelu 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:

Vytváření projektu aplikace Excel doplněk pro Excel.
Psaní kódu, který používá model objektu aplikace Excel přidat text k sešitu při jeho uložení.
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.
Excel 2013 nebo Excel 2010.

Vytváření projektu

Vytvoření nové aplikace Excel doplněk 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 doplněk aplikace Excel 2010 nebo doplněk aplikace Excel 2013.
V název zadejte FirstExcelAddIn.
Klikněte na tlačítko OK.

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

Psaní kódu přidejte Text uložený sešit

Dále přidejte kód do souboru kódu ThisAddIn.Nový kód používá model objektu aplikace Excel vložit často používaný text v prvním řádku aktivního listu.List, který je otevřen, když uživatel uloží sešit je aktivní list.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 Excel.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í Excel 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.

Chcete-li přidat řádek textu uložený sešit

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

Když uživatel uloží sešit, přidá obslužnou rutinu události nový text na začátku aktivního listu.

Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
    Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
    Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
    Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
    newFirstRow.Value2 = "This text was added by using code" 
End Sub

void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

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_WorkbookBeforeSave obslužnou rutinu události WorkbookBeforeSave události.
```
this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);
```

Předchozí příklady kódu změnit sešit 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 Excel.
Wb Parametr obslužnou rutinu události WorkbookBeforeSave události.Wb Parametr je Workbook objekt, který reprezentuje uložený sešit.Další informace naleznete v tématu Přehled modelu objektů aplikace Excel.

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 Excel 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 Excel sešit uložte.
Ověřte, že následující text je přidán do sešitu.

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

Č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 Excel 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 Excel, 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 Excel: Řešení pro aplikaci Excel.
Použití objektového modelu aplikace Excel: Přehled modelu objektů aplikace Excel.
Přizpůsobení uživatelského rozhraní (UI) aplikace Excel, 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 Excel: Sestavování řešení pro systém Office.
Zavedení doplňky aplikace Excel: Nasazení řešení Office.