Office Projelerindeki Olaylar
Her Office proje şablonu otomatik olarak birçok olay işleyicisi oluşturur.Belge düzeyi özelleştirmeleri için olan olay işleyicileri uygulama düzeyi eklentileri için olan olay işleyicilerinden biraz farklıdır.
Uygulama hedefi: Bu konudaki bilgiler, Office 2013 ve Office 2010 için belge düzeyi projeler ve uygulama düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.
Belge Düzeyi Projeleri
Visual Studio yaratılmış kodu belge düzeyi özelleştirmelerindeki yeni veya mevcut belgelerin ya da çalışma kitaplarının arkasında sağlar.Bu kod, iki farklı olay oluşturur: Startup ve Shutdown.
Startup Olayı
Belge çalışıyorken ve derlemedeki başlangıç kodunun tümü çalıştıktan sonra Startup olayı konak öğelerinin (belge, çalışma kitabı veya çalışma sayfası) her biri için oluşturulur.Bu, kodunuzun çalıştığı sınıfın yapıcısında çalıştırılacak son şeydir.Konak öğeleri hakkında daha fazla bilgi için, bkz. Ana Bilgisayar Öğelerine ve Denetimlerine Genel Bakış.
Belge düzeyi projesi oluşturduğunuzda, Visual Studio yaratılmış kodda Startup olayı için olay işleyicileri oluşturur:
Microsoft Office Word projeleri için, olay işleyicisi ThisDocument_Startup olarak adlandırılır.
Microsof Office Excel Projeleri için, olay işleyicileri aşağıdaki isimlere sahiptir:
Sheet1_Startup
Sheet2_Startup
Sheet3_Startup
ThisWorkbook_Startup
Kapatma Olayı
Kodunuzun yüklü olduğu uygulama etki alanı kaldırılmak üzere olduğunda Shutdown olayı, her bir konak öğesi (belge veya çalışma sayfası) için oluşturulur.Bu, kaldırıldığında sınıfta çağırılacak son şeydir.
Belge düzeyi projesi oluşturduğunuzda, Visual Studio yaratılmış kodda Shutdown olayı için olay işleyicileri oluşturur:
Microsoft Office Word projeleri için, olay işleyicisi ThisDocument_Shutdown olarak adlandırılır.
Microsof Office Excel Projeleri için, olay işleyicileri aşağıdaki isimlere sahiptir:
Sheet1_Shutdown
Sheet2_Shutdown
Sheet3_Shutdown
ThisWorkbook_Shutdown
[!NOT]
Belgenin Shutdown olay işleyicisi sırasında programlı olarak denetimleri kaldırmayın.Shutdown olayı olduğunda UI öğeleri artık kullanılamaz. Uygulama kapanmadan denetimleri kaldırmak istiyorsanız, kodunuza başka olay işleyicisi ekleyin, örn. BeforeClose veya BeforeSave.
Olay İşleyicisi Yöntem Bildirimleri
Kendisine iletilen aynı argüman her olay işleyicisi yöntem bildirimi vardır: sender ve e.Excel'de, sender bağımsız değişkeni sayfa anlamına gelir, örn. Sheet1 veya Sheet2; Word'de sender bağımsız değişkeni belge anlamına gelir.e bağımsız değişkeni, bu durumda kullanılmayan, olay için standart bağımsız değişkeni anlamına gelir.
Aşağıdaki kod örneğinde Word için belge düzeyi projelerindeki varsayılan olay işleyicileri gösterilir.
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)
{
}
Aşağıdaki kod örneğinde Excel için belge düzeyi projelerindeki varsayılan olay işleyicileri gösterilir.
[!NOT]
Aşağıdaki kod örneğinde Sheet1 sınıfındaki olay işleyicileri gösterilir.Diğer konak öğesi sınıflarındaki olay işleyicilerinin adları sınıf adına karşılık gelmektedir.Örneğin, Sheet2 sınıfının içinde, Startup olay işleyicisi Sheet2_Startup olarak adlandırılır.ThisWorkbook sınıfının içinde, Startup olay işleyicisi ThisWorkbook_Startup olarak adlandırılır.
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)
{
}
Belge Düzeyi Excel Projelerinde Olayların Düzeni
Excel projelerindeki Startup olay işleyicileri bu sırada çağrılır:
ThisWorkbook_Startup.
Sheet1_Startup.
Sheet2_Startup.
Sheet3_Startup.
Sıralı diğer sayfalar.
Çalışma kitabı çözümünde Shutdown olay işleyicileri bu sırada çağırılır:
ThisWorkbook_Shutdown.
Sheet1_Shutdown.
Sheet2_Shutdown.
Sheet3_Shutdown.
Sıralı diğer sayfalar.
Düzen, proje derlendiğinde belirlenir.Eğer kullanıcı sayfaları çalışma anında yeniden düzenlerse, çalışma kitabının bir sonraki açılmasında veya kapatılmasında olayların oluşma sırasını değiştirmez.
Uygulama Düzeyi Projeleri
Visual Studio, uygulama düzeyinde eklentilerinde oluşturulmuş kod sağlar.Bu kod, iki farklı olay oluşturur: Startup ve Shutdown.
Startup Olayı
Startup olayı, eklenti yüklendikten ve derlemedeki tüm başlangıç kodu çalıştıktan sonra oluşur.Bu olay, oluşturulan kod dosyasındaki ThisAddIn_Startup yöntemi tarafından işlenir.
ThisAddIn_Startup olay işleyicisindeki kod, eklentiniz RequestComAddInAutomationService yöntemini geçersiz kılmadığı sürece çalışan ilk kullanıcı kodudur. Bu durumda, ThisAddIn_Startup olay işleyicisi RequestComAddInAutomationService'ten sonra çağrılır.
Ekleme kodu ThisAdd-In_Startup olay işleyicisine kod belge açık olmasını gerektiriyorsa.Bunun yerine, Office uygulaması başlatan kullanıcı oluşturur veya bir belgeyi açan bir olay bu kodu ekleyin.Daha fazla bilgi için bkz. Office uygulaması başladığında, bir belgeye erişme.
Eklentiler için başlangıç dizisi hakkında daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Mimarisi.
Kapatma Olayı
Shutdown olayı, kodunuzun yüklendiği uygulama etki alanı kaldırılmak üzereyken oluşur.Bu olay, oluşturulan kod dosyasındaki ThisAddIn_Shutdown yöntemi tarafından işlenir. Bu olay işleyicisi, eklenti kaldırıldığında çalışacak son kullanıcı kodudur.
Outlook eklentilerinde kapatma olayı
Shutdown Yalnızca kullanıcı eklentiyi Outlook com eklentileri iletişim kutusunu kullanarak bıraktığında olayı oluşturulur.Outlook'tan çıktıktan sonra onu oluşmaz.Outlook'tan çıktıktan sonra çalıştırılmalıdır kodunuz varsa, aşağıdaki olaylardan biri işler:
Quit , Olay Application nesne.
[!NOT]
Yükseltmek için Outlook'u zorlayabilirsiniz Shutdown kayıt defterini değiştirerek çıktığında olayı.Bir yönetici bu ayar döner, ancak herhangi için eklediğiniz kod ThisAddIn_Shutdown yöntemi artık Outlook'tan çıktıktan sonra çalışır.Daha fazla bilgi için bkz: Kapatma değişiklikler Outlook 2010 için.
Ayrıca bkz.
Görevler
Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma
Diğer Kaynaklar
Belge Düzeyi Özelleştirmelerini Programlama