Doplňky aplikace úroveň programování

Při rozšíření aplikace Microsoft Office vytvořením doplněk aplikační úrovni zapisovat kód přímo ThisAddIn tříd v projektu.Tato třída můžete provádět úkoly přístupu k modelu objektu hostitele aplikace Microsoft Office, přizpůsobení uživatelského rozhraní (UI) aplikací a vystavení objekty doplněk jiných Office Solutions.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v systému Microsoft Office 2013 a Microsoft Office 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Některé aspekty psaní kódu v projektech doplňku se liší od jiných typů projektů v aplikaci Visual Studio.Mnoho těchto rozdílů jsou příčinou způsob Office objektové modely jsou vystaveny na spravovaný kód.Další informace naleznete v tématu Psaní kódu v řešení Office.

Obecné informace o doplňky úroveň aplikace a další typy řešení můžete vytvořit pomocí nástroje pro vývoj Office v sadě Visual Studio, viz Přehled vývoje řešení sady Office.

Pomocí třídy ThisAddIn

Začnete psát do kód ThisAddIn třídy.Visual Studio automaticky generuje v ThisAddIn.vb této třídy (v Visual Basic) nebo ThisAddIn.cs (v jazyce C#) soubor kódu v projektu doplňku.Visual Studio Tools for Office runtime Pro vás automaticky vytvoří této třídy při načtení doplňku aplikace Microsoft Office.

Existují dva výchozí obslužné rutiny v ThisAddIn třídy.Při načtení doplňku spustit kód, přidejte kód, který ThisAddIn_Startup obslužné rutiny události.Doplněk je uvolněna před spustit kód, přidejte kód, který ThisAddIn_Shutdown obslužné rutiny události.Další informace o tyto obslužné rutiny událostí, viz Události v projektech Office.

[!POZNÁMKA]

Aplikace Outlook ve výchozím nastavení ThisAddIn_Shutdown obslužnou rutinu události není volána vždy, když doplněk je uvolněna.Další informace naleznete v tématu Události v projektech Office.

Přístup k objektovému modelu aplikace hostitele

Přístup k objektovému modelu aplikace hostitele, použijte Application pole ThisAddIn třídy.Toto pole vrátí objekt, který představuje aktuální instance hostitelské aplikace.Následující tabulka uvádí typ návratové hodnoty Application v každé přidat projekt.

Hostitelská aplikace	Vrátí hodnotu typu
Aplikace Microsoft Office Excel	Microsoft.Office.Interop.Excel.Application
Aplikace Microsoft Office InfoPath.	Microsoft.Office.Interop.InfoPath.Application
Aplikace Microsoft Office Outlook	Microsoft.Office.Interop.Outlook.Application
Aplikace Microsoft Office PowerPoint	Microsoft.Office.Interop.PowerPoint.Application
Aplikace Microsoft Office Project	Microsoft.Office.Interop.MSProject.Application
Aplikace Microsoft Office Visio.	Microsoft.Office.Interop.Visio.Application
Aplikace Microsoft Office Word	Microsoft.Office.Interop.Word.Application

Následující příklad kódu ukazuje, jak použít Application pole vytvořit nový sešit v doplňku Microsoft Office Excel.Tento příklad je určen ke spuštění z ThisAddIn třídy.

Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()

Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);

Proveďte totéž z mimo ThisAddIn třídy, použijte Globals objektu přístup ThisAddIn třídy.Další informace o Globals objekt, viz Globální přístup k objektům v projektech Office.

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()

Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);

Další informace o modelech objektu specifických aplikací sady Microsoft Office naleznete v následujících tématech:

• Přehled modelu objektu aplikace Excel

• Přehled modelu objektu Word

• Přehled Model objektu aplikace Outlook

• Řešení aplikace InfoPath

• Řešení aplikace PowerPoint

• Řešení projektu

• Přehled modelu objektu aplikace Visio

Přístup k dokumentu při spuštění aplikace sady Office

Všechny Office 2010 při spuštění je a žádná aplikace automaticky otevřít dokument Office 2013 aplikace otevřít dokument při jejich spuštění.Není proto přidejte kód ThisAdd-In_Startup Pokud otevřete dokument vyžaduje kód obslužné rutiny události.Místo toho přidejte kód k události, která vyvolává aplikace Office, když uživatel vytvoří nebo otevře dokument.Tímto způsobem lze zaručit, dokument je otevřen před váš kód provádí operace v něm.

Následující příklad kódu pracuje s dokumentem aplikace Word pouze v případě, že uživatel vytvoří dokument nebo otevře existující dokument.

Private Sub ThisAddIn_Startup() Handles Me.Startup

    AddHandler Application.NewDocument, AddressOf WorkWithDocument

End Sub

Private Sub WorkWithDocument(ByVal Doc As Microsoft.Office.Interop.Word.Document) _
    Handles Application.DocumentOpen

    Dim rng As Word.Range = Doc.Range(Start:=0, End:=0)
    rng.Text = " New Text "
    rng.Select()

End Sub

Členové ThisAddIn použití pro jiné úkoly.

Následující tabulka popisuje jiných běžných úkolů a ukazuje, které členy ThisAddIn třídy můžete použít k provádění úkolů.

Úloha	Člen použít
Spuštění kódu inicializace doplněk při načtení doplněk.	Přidejte kód ThisAddIn_Startup metoda.Toto je výchozí obslužnou rutinu Startup události.Další informace naleznete v tématu Události v projektech Office.
Spuštění kódu vyčištění prostředků používaných doplněk před doplněk je uvolněna.	Přidejte kód ThisAddIn_Shutdown metoda.Toto je výchozí obslužnou rutinu Shutdown události.Další informace naleznete v tématu Události v projektech Office. Poznámka Aplikace Outlook ve výchozím nastavení ThisAddIn_Startup obslužnou rutinu události není volána vždy, když doplněk je uvolněna.Další informace naleznete v tématu Události v projektech Office.
Zobrazte vlastní podokno úloh.	Použití CustomTaskPanes pole.Další informace naleznete v tématu Vlastní podokna úloh.
Odkrýt objekty v doplněk k jiné řešení Microsoft Office.	Přepsat RequestComAddInAutomationService metoda.Další informace naleznete v tématu Volací kód v úrovni aplikace doplňky z dalších řešení sady Office.
Implementace rozhraní rozšiřitelnosti upravte funkce systému Microsoft Office.	Přepsat RequestService metoda vrátí instanci třídy, která implementuje rozhraní.Další informace naleznete v tématu Úprava funkce uživatelského rozhraní pomocí rozšíření rozhraní. Poznámka Přizpůsobit uživatelské rozhraní pásu karet, můžete také přepsat CreateRibbonExtensibilityObject metoda.

Principy návrhu třídy ThisAddIn

V projektech cílených .NET Framework 4, Microsoft.Office.Tools.AddIn rozhraní.ThisAddIn Třída odvozena z Microsoft.Office.Tools.AddInBase třídy.Tento základní třídy přesměruje volání všech jeho členů vnitřní implementace Microsoft.Office.Tools.AddIn v rozhraní Visual Studio Tools for Office runtime.

V projektech doplňku pro aplikaci Outlook ThisAddIn třída odvozena z Microsoft.Office.Tools.Outlook.OutlookAddIn třídy v projektech cílených 3.5 rozhraní.NET Framework a z Microsoft.Office.Tools.Outlook.OutlookAddInBase v projektech cílených .NET Framework 4.Tyto základní třídy poskytují další funkce pro podporu oblastí formulářů.Další informace o oblasti formulářů naleznete v Vytvoření oblasti formulářů aplikace Outlook.

Přizpůsobení uživatelského rozhraní aplikací sady Microsoft Office

Aplikace uživatelského rozhraní sady Microsoft Office můžete upravit programově pomocí doplněk aplikační úrovni.Můžete například přizpůsobit pás karet podokno úloh vlastní zobrazení nebo vytvořit vlastní formulář oblast v aplikaci Outlook.Další informace naleznete v tématu Přizpůsobení uživatelského rozhraní sady Office.

Visual Studio poskytuje návrháři a třídy, které můžete použít k vytvoření vlastní podokna úloh, vlastní nastavení pásu karet a oblastí formulářů aplikace Outlook.Tyto designery a třídy pomoci zjednodušit proces přizpůsobení těchto funkcí.Další informace naleznete v tématu Vlastní podokna úloh, Návrhář pásu karet a Vytvoření oblasti formulářů aplikace Outlook.

Pokud chcete upravit jeden z těchto funkcí způsobem, který není podporován, třídy a návrháři, můžete také přizpůsobit tyto funkce implementací Rozšiřitelnost rozhraní v doplňku.Další informace naleznete v tématu Úprava funkce uživatelského rozhraní pomocí rozšíření rozhraní.

Navíc můžete upravit uživatelské rozhraní aplikace Word dokumenty a sešitů aplikace Excel generování hostitel položek, které rozšiřují chování dokumenty a sešitů.Umožňuje přidat do dokumentů, sešitů a spravované ovládací prvky.Další informace naleznete v tématu Rozšíření dokumenty aplikace Word a Excel v doplňky úroveň aplikace v době spuštění.

Volání kódu v úrovni aplikace doplňky od jiných řešení

Objekty můžete vystavit v doplněk do jiných řešení, včetně dalších řešení Office.To je užitečné, pokud doplněk poskytuje služby, které chcete povolit použít jiné řešení.Například pokud máte doplněk aplikace Microsoft Office Excel provádí výpočty finančních dat z webové služby dalších řešení tyto výpočty provést pomocí volání doplněk aplikace Excel v době běhu.

Další informace naleznete v tématu Volací kód v úrovni aplikace doplňky z dalších řešení sady Office.

Viz také

Úkoly

Názorný postup: Volání kódu v doplňku úrovni aplikace VBA

Jak: vytvoření Office projekty v aplikaci Visual Studio

Koncepty

Rozšíření dokumenty aplikace Word a Excel v doplňky úroveň aplikace v době spuštění

Volací kód v úrovni aplikace doplňky z dalších řešení sady Office

Úprava funkce uživatelského rozhraní pomocí rozšíření rozhraní

Architektura doplňků úroveň aplikace

Psaní kódu v řešení Office

Další zdroje

Vývoj řešení sady Office