Uygulama Düzeyi Eklentileri Programlama
Uygulama düzeyi eklentisi oluşturarak Microsoft Office uygulaması genişlettiğinizde, projenizdeki ThisAddIn sınıfına karşı doğrudan kod yazarsınız. Bu sınıfı, Microsoft Office konak uygulamasının nesne modeline erişmek, uygulamanın kullanıcı arayüzünü (UI) özelleştirmek ve eklentinizdeki nesneleri diğer Office çözümlerine uygulayamak gibi görevleri gerçekleştirmek üzere bu sınıfı kullanabilirsiniz.
Uygulama alanı: Bu konudaki bilgiler, Microsoft Office 2010 ve 2007 Microsoft Office sisteminin uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz: Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.
Eklenti projelerinde kod yazmanın bazı açıları Visual Studio'daki diğer tür projelerden farklıdır. Bu farklılıkların birçoğuna Office nesne modellerinin yönetilen koda uygulanma yolu sebep olur. Daha fazla bilgi için bkz. Office Çözümlerinde Kod Yazma.
Uygulama düzeyi eklentilerini ve Visual Studio'da Office geliştirme araçlarını kullanarak oluşturabileceğiniz çözümlerin diğer türleri hakkında genel bilgi için, bkz. Office Çözümleri Geliştirmesine Genel Bakış.
ThisAddIn Sınıfını Kullanma
ThisAddIn sınıfında eklenti kodunuzu yazmaya başlayabilirsiniz. Eklenti projenizin ThisAddIn.vb (Visual Basic'de) veya ThisAddIn.cs (C#'ta) kod dosyasında Visual Studio otomatik olarak bu sınıfı oluşturur. Microsoft Office uygulaması eklentinizi yüklediğinde, Visual Studio Tools for Office çalışma zamanı modülü otomatik olarak bu sınıfın örneğini sizin için oluşturur.
ThisAddIn sınıfında varsayılan olarak iki tane olay işleyicisi vardır. Eklenti yüklendiğinde kodu çalıştırmak için, kodu ThisAddIn_Startup olay işleyicisine ekleyin. Eklenti kaldırılmadan hemen önce kodu çalıştırmak için, kodu ThisAddIn_Shutdown olay işleyicisine ekleyin. Bu olay işleyicileri hakkında daha fazla bilgi için, bkz. Office Projelerindeki Olaylar.
Not
Varsayılan olarak, Outlook 2010, ThisAddIn_Shutdown olay işleyicisi değil her zaman verilir eklenti kaldırıldığında. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.
Konak Uygulamasının Nesne Modeline Erişme
Konak uygulamasının nesne modeline erişmek için, ThisAddIn sınıfının Application alanını kullanın. Bu alan, konak uygulamasının geçerli örneğini gösteren nesneyi döndürür. Aşağıdaki tabloda, her eklenti projesindeki Application alanı için dönüş değeri türleri listelenir.
Konak Uygulama |
Dönüş değeri türü |
|---|---|
Microsoft Office Excel |
|
Microsoft Office InfoPath |
|
Microsoft Office Outlook |
|
Microsoft Office PowerPoint |
|
Microsoft Office Project 2007 |
Microsoft.Office.Interop.MSProject.Application |
Microsoft Office Visio |
Microsoft.Office.Interop.Visio.Application |
Microsoft Office Word |
Aşağıdaki kod örneğinde, Microsoft Office Excel için eklentide yeni bir çalışma kitabını oluşturmak amacıyla Application alanının nasıl kullanılacağı gösterilmektedir. Bu örnek, ThisAddIn sınıfından çalıştırılmak üzere tasarlanmıştır.
Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()
Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);
ThisAddIn sınıfının dışından aynı şeyi yapmak için,ThisAddIn sınıfına erişmek üzere Globals nesnesini kullanın. Globals nesnesi hakkında daha fazla bilgi için, bkz. Office Projeleri Nesnelerine Genel Erişim.
Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()
Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);
Özel Microsoft Office uygulamalarının nesne modelleri hakkında daha fazla bilgi için, aşağıdaki konulara bakın:
Diğer Görevler İçin Kullanmak Üzere ThisAddIn Üyeleri
Aşağıdaki tabloda, diğer ortak görevler anlatılır ve görevleri gerçekleştirmek için ThisAddIn sınıfının hangi üyelerini kullanabileceğiniz gösterilir.
Görev |
Kullanılacak üye |
|---|---|
Eklenti yüklendiğinde, eklentiyi başlatmak için kodu çalıştırma. |
ThisAddIn_Startup yöntemine kodunuzu ekleyin. Bu, Startup olayı için varsayılan olay işleyicisidir. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar. |
Eklenti kaldırılmadan önce eklenti tarafından kullanılan kaynakları temizlemek için kodu çalıştırma. |
ThisAddIn_Shutdown yöntemine kodunuzu ekleyin. Bu, Shutdown olayı için varsayılan olay işleyicisidir. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar. .gif "Not") Not
Varsayılan olarak, Outlook 2010, ThisAddIn_Startup olay işleyicisi değil her zaman verilir eklenti kaldırıldığında.Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.
|
Özel görev bölmesini görüntüleme. |
CustomTaskPanes alanını kullanın. Daha fazla bilgi için bkz. Özel Görev Bölmelerine Genel Bakış. |
Açık olan herhangi bir Word belgesinde veya Excel çalışma kitabında tanınabilen akıllı etiket oluşturma. Not
Excel 2010 ve Word 2010'de akıllı etiketlerin kullanımı terk edilmiştir. Daha fazla bilgi için bkz. Akıllı Etiketlere Genel Bakış.
|
Excel ve Word için eklentideki VstoSmartTags alanını kullanın. Daha fazla bilgi için bkz. Akıllı Etiketlere Genel Bakış. |
Eklenti nesnelerini diğer Microsoft Office çözümleriyle oluşturma. |
RequestComAddInAutomationService yöntemini geçersiz kılın. Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentilerindeki Kodu Başka Office Çözümlerinden Çağırma. |
Genişletilebilirlik arayüzünü uygulayarak Microsoft Office sistemindeki özelliği özelleştirme. |
Arayüzü uygulayan sınıfın bir örneğini döndürmek için RequestService yöntemini geçersiz kılın. Daha fazla bilgi için bkz. Genişletilebilirlik Arabirimi Kullanarak Kullanıcı Arabirimi (KA) Özelliklerini Özelleştirme. Not
Şerit UI'ını özelleştirmek için, CreateRibbonExtensibilityObject yöntemini de geçersiz kılabilirsiniz.
|
ThisAddIn Sınıfının Tasarımını Anlama
.NET Framework 3.5'i hedefleyen projelerde, ThisAddIn sınıfı, Visual Studio Tools for Office çalışma zamanı modülü'da Microsoft.Office.Tools.AddIn sınıfından türetilir.
.NET Framework 4'i hedefleyen projelerde, Microsoft.Office.Tools.AddIn arayüzdür, böylece yaratılmış ThisAddIn sınıfı herhangi bir uygulama türetemez. Bunun yerine, ThisAddIn sınıfı Microsoft.Office.Tools.AddInBase sınıfından türetilir. Taban sınıfı, Microsoft.Office.Tools.AddIn arayüzünün iç uygulamasının üyelerine yapılan çağrıları Visual Studio Tools for Office çalışma zamanı modülü'da yeniden yönlendirir. .NET Framework 3.5'i hedefleyen projeler için Visual Studio Tools for Office çalışma zamanı modülü ve .NET Framework 4 arasındaki farklar hakkında daha fazla bilgi için, bkz. Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.
Outlook'taki eklenti projelerinde, ThisAddIn sınıfı, .NET Framework 3.5'i hedefleyen projelerdeki Microsoft.Office.Tools.Outlook.OutlookAddIn sınıfından ve projelerde .NET Framework 4 hedefleyen Microsoft.Office.Tools.Outlook.OutlookAddInBase'den türetilir. Bu temel sınıflar form bölgesini desteklemek için bazı ek işlevsellik sağlar. Form bölgeleri hakkında daha fazla bilgi için, bkz. Outlook Form Bölgeleri Yaratma.
Microsoft Officem Uygulamasının Kullanıcı Arayüzünü Özelleştirme
Uygulama düzeyi eklentisi kullanarak Microsoft Office uygulamalarının UI'ını programlı olarak özelleştirebilirsiniz. Örneğin, Şeriti özelleştirebilir, özel görev bölmesini görüntüleyebilir veya Outlook'ta özel form bölgesi oluşturabilirsiniz. Daha fazla bilgi için bkz. Office UI Özelleştirmesi.
Visual Studio, özel görev bölmeleri, Şerit özelleştirmeleri ve Outlook form bölgelerini oluşturmak için kullanabileceğiniz tasarımcılar ve sınıflar sağlar. Bu tasarımcılar ve sınıflar, bu özellikleri özelleştirme işlemini basitleştirmeye yardım eder. Daha fazla bilgi için, bkz: Özel Görev Bölmelerine Genel Bakış, Şerit Tasarımcısı ve Outlook Form Bölgeleri Yaratma
Eğer bu özelliklerden birini, tasarımcıların ve sınıfların desteklemediği bir yoldan özelleştirmek isterseniz, bu özellikleri eklentinizde genişletilebilirlik arayüzü uygulayarak da özelleştirebilirsiniz. Daha fazla bilgi için bkz. Genişletilebilirlik Arabirimi Kullanarak Kullanıcı Arabirimi (KA) Özelliklerini Özelleştirme.
Belgelerin ve çalışma kitaplarının davranışlarını genişleten konak öğeleri yaratarak, Word belgelerinin ve Excel çalışma kitaplarının UI'ını değiştirebilirsiniz. Bu, belgelere ve çalışma kitaplarına yönetilen denetimler ve akıllı etiketler eklemenize olanak sağlar. Daha fazla bilgi için bkz. Word Belgelerini ve Excel Çalışma Kitaplarını Çalıştırma Zamanında Uygulama Düzeyi Eklentileri İçinde Genişletme.
Uygulama Düzeyi Eklentilerindeki Kodu Diğer Çözümlerden Çağırma
Eklenti nesnelerini, diğer Office çözümleri dahil olmak üzere başka çözümlerle oluşturabilirsiniz. Eğer eklentiniz, diğer çözümlerin kullanması için etkinleştirmek istediğiniz bir hizmet sağlıyorsa, bu yararlıdır. Örneğin, Microsoft Office Excel için Web sunucusundan finansal veri üzerine hesaplamalar gerçekleştiren eklentiniz varsa, diğer çözümler bu çözümleri çalışma zamanında Excel eklentisini çağırarak gerçekleştirebilir.
Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentilerindeki Kodu Başka Office Çözümlerinden Çağırma.
Ayrıca bkz.
Görevler
İzlenecek Yol: Uygulama Düzeyi Eklentilerindeki Kodu VBA'dan Çağırma
Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma
Kavramlar
Uygulama Düzeyi Eklentilerindeki Kodu Başka Office Çözümlerinden Çağırma
Genişletilebilirlik Arabirimi Kullanarak Kullanıcı Arabirimi (KA) Özelliklerini Özelleştirme
Uygulama Düzeyi Eklentisi Mimarisi