Programování doplňků na úrovni aplikace
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 Microsoft Office 2013 a Microsoft Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému 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ích pro systém 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í pro systém 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 pro systém 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 pro systém 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 |
|
Aplikace Microsoft Office InfoPath. |
|
Aplikace Microsoft Office Outlook |
|
Aplikace Microsoft Office PowerPoint |
|
Aplikace Microsoft Office Project |
Microsoft.Office.Interop.MSProject.Application |
Aplikace Microsoft Office Visio. |
Microsoft.Office.Interop.Visio.Application |
Aplikace Microsoft Office Word |
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 pro systém 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ří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
private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
this.Application.DocumentOpen +=
new Word.ApplicationEvents4_DocumentOpenEventHandler(WorkWithDocument);
((Word.ApplicationEvents4_Event)this.Application).NewDocument +=
new Word.ApplicationEvents4_NewDocumentEventHandler(WorkWithDocument);
}
private void WorkWithDocument(Microsoft.Office.Interop.Word.Document Doc)
{
try
{
Word.Range rng = Doc.Range(0, 0);
rng.Text = "New Text";
rng.Select();
}
catch (Exception ex)
{
// Handle exception if for some reason the document is not available.
}
}
Č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 pro systém 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 pro systém 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 Volání kódu v doplňcích na úrovni aplikace z jiných řešení pro systém 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 Přizpůsobení funkcí uživatelského rozhraní pomocí rozšiřujících rozhraní.
|
Principy návrhu třídy ThisAddIn
V projektech cílených .NET Framework 4, AddIn rozhraní.ThisAddIn Třída odvozena z AddInBase třídy.Tento základní třídy přesměruje volání všech jeho členů vnitřní implementace 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 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 Vytváření oblastí 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í systému 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 Vytváření oblastí 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 Přizpůsobení funkcí uživatelského rozhraní pomocí rozšiřujících 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í dokumentů aplikace Word a sešitů aplikace Excel v doplňcích na úrovni aplikace za běhu.
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 Volání kódu v doplňcích na úrovni aplikace z jiných řešení pro systém Office.
Viz také
Úkoly
Návod: Volání kódu v doplňku na úrovni aplikace z jazyka VBA
Postupy: Vytváření projektů pro systém Office v prostředí Visual Studio
Koncepty
Rozšíření dokumentů aplikace Word a sešitů aplikace Excel v doplňcích na úrovni aplikace za běhu
Volání kódu v doplňcích na úrovni aplikace z jiných řešení pro systém Office
Přizpůsobení funkcí uživatelského rozhraní pomocí rozšiřujících rozhraní
Architektura doplňků na úrovni aplikace
Psaní kódu v řešeních pro systém Office