Události v projektech pro systém Office
Každá šablona projektu Office automaticky generuje několik obslužných rutin událostí.Obslužné rutiny událostí pro úpravy na úrovni dokumentu se mírně liší z obslužných rutin událostí pro doplňky aplikace.
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v Office 2013 a v Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.
Projekty na úrovni dokumentu
Visual Studio poskytuje generovaný kód nové nebo existující dokumenty nebo listy v přizpůsobení úroveň dokument.Tento kód vyvolá dvě různé události: Startup a Shutdown.
Událost spuštění
Startup Událost je aktivována pro jednotlivé položky hostitel (dokumentu, sešitu nebo listu) po spuštění dokumentu a spuštění kódu inicializace v sestavení.Je poslední věcí v konstruktoru třídy, která je kód spuštěn v.Další informace o položkách hostitele naleznete v Přehled hostitelských položek a hostitelských ovládacích prvků.
Při vytváření dokumentu úroveň projektu aplikace Visual Studio vytvoří obslužných rutin událostí Startup události v souborech generovaný kód:
Pro projekty aplikace Microsoft Office Word obslužnou rutinu události s názvem ThisDocument_Startup.
Obslužné rutiny událostí pro projekty aplikace Microsoft Office Excel mají následující názvy:
Sheet1_Startup
Sheet2_Startup
Sheet3_Startup
ThisWorkbook_Startup
Událost vypnutí
Shutdown Událost je aktivována pro jednotlivé položky hostitel (dokument nebo sešit) Pokud je váš kód je načten do domény aplikace chcete uvolnit.Je nakonec volané třídy jako jeho uvolnění.
Při vytváření dokumentu úroveň projektu aplikace Visual Studio vytvoří obslužných rutin událostí Shutdown události v souborech generovaný kód:
Pro projekty aplikace Microsoft Office Word obslužnou rutinu události s názvem ThisDocument_Shutdown.
Obslužné rutiny událostí pro projekty aplikace Microsoft Office Excel mají následující názvy:
Sheet1_Shutdown
Sheet2_Shutdown
Sheet3_Shutdown
ThisWorkbook_Shutdown
[!POZNÁMKA]
Neodstraňujte programově ovládací prvky během Shutdown obslužné rutiny události dokumentu.Prvky uživatelského rozhraní dokumentu již nejsou k dispozici při Shutdown události.Pokud chcete před zavřením aplikace odebrat ovládací prvky, přidat kód pro jiné obslužnou rutinu události, jako BeforeClose nebo BeforeSave.
Deklarace metody obslužné rutiny události
Každá deklarace metody obslužné rutiny události má stejné argumenty předané: sender a e.V aplikaci Excel sender argument odkazuje na list jako Sheet1 nebo Sheet2; v aplikaci Word sender argument se vztahuje k dokumentu.e Argument odkazuje na standardní argumenty události, které nejsou v tomto případě použít.
Následující příklad kódu ukazuje výchozí obslužné rutiny v projekty na úrovni dokumentu aplikace Word.
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Startup
End Sub
Private Sub ThisDocument_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Shutdown
End Sub
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
}
private void ThisDocument_Shutdown(object sender, System.EventArgs e)
{
}
Následující příklad kódu ukazuje výchozí obslužné rutiny v projekty na úrovni dokumentu aplikace Excel.
[!POZNÁMKA]
Následující příklad ukazuje obslužné rutiny události v Sheet1 třídy.Názvy obslužných rutin událostí v jiných třídách položku hostitele odpovídat názvu třídy.Například v Sheet2 třídy, Startup obslužnou rutinu události s názvem Sheet2_Startup.V ThisWorkbook třídy, Startup obslužnou rutinu události s názvem ThisWorkbook_Startup.
Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Startup
End Sub
Private Sub Sheet1_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Shutdown
End Sub
private void Sheet1_Startup(object sender, System.EventArgs e)
{
}
private void Sheet1_Shutdown(object sender, System.EventArgs e)
{
}
Pořadí událostí v projektech úrovni dokumentu aplikace Excel
Startup Se nazývají obslužné rutiny událostí v projektech aplikace Excel v tomto pořadí:
ThisWorkbook_Startup.
Sheet1_Startup.
Sheet2_Startup.
Sheet3_Startup.
Ostatní listy v pořadí.
Shutdown Se nazývají obslužné rutiny události v sešitu řešení v tomto pořadí:
ThisWorkbook_Shutdown.
Sheet1_Shutdown.
Sheet2_Shutdown.
Sheet3_Shutdown.
Ostatní listy v pořadí.
Pořadí je určeno při kompilaci projektu.Pokud uživatel změní uspořádání listů za běhu, nezmění pořadí, že události jsou vyvolány při příštím otevření nebo zavření sešitu.
Projekty na úrovni aplikace
Visual Studio poskytuje generovaný kód doplňky úrovni aplikace.Tento kód vyvolá dvě různé události: Startup a Shutdown.
Událost spuštění
Startup Událost je aktivována po načtení doplňku a spuštění kódu inicializace v sestavení.Tato událost je zpracována ThisAddIn_Startup metoda v souboru generovaného kódu.
Kód ThisAddIn_Startup obslužná rutina události je první uživatelský kód spustit, pokud není doplněk přepíše RequestComAddInAutomationService metoda.V tomto případě ThisAddIn_Startup obslužná rutina události je volána po RequestComAddInAutomationService.
Nechcete přidat 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.Další informace naleznete v tématu Přístup k dokumentu při spuštění aplikace sady Office.
Další informace o spouštění doplňky, viz Architektura doplňků na úrovni aplikace.
Událost vypnutí
Shutdown Událost je vyvolána, když váš kód je načten do domény aplikace je uvolněna.Tato událost je zpracována ThisAddIn_Shutdown metoda v souboru generovaného kódu.Tato obslužná rutina události je kód poslední uživatel spustit doplněk je uvolněn.
Událost vypnutí v doplňky aplikace Outlook
Shutdown Událost je aktivována pouze v případě, že uživatel zakáže doplněk pomocí dialogovém okně Doplňky modelu COM aplikace Outlook.Není vyvolána při ukončení aplikace Outlook.Máte-li kód, který musí být spuštěn při ukončení aplikace Outlook zpracujte buď následující události:
Quit Události Application objektu.
[!POZNÁMKA]
Můžete vynutit Outlook zvýšit Shutdown události při jejím ukončení úpravou registru.Však pokud správce toto nastavení se vrátí, libovolný kód přidat ThisAddIn_Shutdown metoda již spustí při ukončení aplikace Outlook.Další informace naleznete v Změny vypnutí pro aplikaci Outlook 2010.
Viz také
Úkoly
Postupy: Vytváření projektů pro systém Office v prostředí Visual Studio
Další zdroje
Vývoj řešení pro systém Office
Programování přizpůsobení na úrovni dokumentu