Office Projelerindeki Olaylar

Makale
02/26/2013

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 alanı: Bu konudaki bilgiler Office 2013 ve Office 2010'un belge düzeyi projelerine ve uygulama düzeyi projelerine yöneliktir. Bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

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. Konak Öğeleri ve Konak Kontrollerine 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 Eklentisi 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.
Close , Olay Explorer 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.