İzlenecek yol: İlk uygulama düzeyinde eklentiniz Word oluşturma
Bu giriş anlatımında Microsoft Office Word için uygulama düzeyi eklentilerin nasıl oluşturulduğu gösterilir.Bu tarz çözümde oluşturduğunuz özellikler hangi belgenin açık olduğuna bağlı olmaksızın uygulamanın kendisinde kullanılabilir.
Uygulama alanı: Bu konudaki bilgiler Word 2013 ve Word 2010 uygulamalarının uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.
Bu örneklerde aşağıdaki görevler gösterilir:
Word eklenti projesi oluşturma.
Kaydedildiğinde belgeye metin eklemek için Word nesne modelini kullanan kod yazma.
Test etmek için projeyi oluşturma ve çalıştırma.
Geliştirici bilgisayarınızdaki tamamlanmış projeyi eklentinin artık otomatik olarak çalışmaması için temizleme.
[!NOT]
Bilgisayarınızda, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazılarının adı veya konumu farklı gösterilebilir. Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler. Daha fazla bilgi için bkz: Visual Studio ayarları.
Önkoşullar
Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:
-
Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2012 sürümü. Daha fazla bilgi için bkz: [Office Çözümeri Geliştirmek İçin Bilgisayarı Yapılandırma](bb398242\(v=vs.110\).md).
- Word 2013 veya Word 2010.
Projeyi Oluşturma
Visual Studio'da yeni Word eklenti projesi oluşturmak için
Visual Studio uygulamasını başlatın.
Dosya menüsünde, Yeni'nin üzerine gelin ve Proje'ye tıklatın.
Şablonlar bölmesinde genişletin Visual C# veya Visual Basicve sonra genişletin Office/SharePoint.
Genişletilmiş altında Office/SharePoint düğümü, select Office eklentileri düğümü.
Proje şablonları listesinde Word 2010 Eklentisi'ni ya da Word 2013 Eklentisi'ni seçin.
Ad kutusuna, FirstWordAddIn yazın.
Tamam düğmesini tıklatın.
Visual Studio, FirstWordAddIn projesini oluşturur ve ThisAddIn kod dosyasını düzenleyicide açar.
Kaydedilmiş Belgeye Metin Eklemek İçin Kod Yazma
Sonra, kodu ThisAddIn kod dosyasına ekleyin.Yeni kod, şablon metni her kaydedilen belgeye eklemek için Word nesne modelini kullanır.Varsayılan olarak ThisAddIn kod dosyası aşağıdaki oluşturulmuş kodu içerir:
ThisAddIn sınıfının kısmi tanımlaması.Bu sınıf kodunuz için bir giriş noktası sunar ve Word'ün nesne modeline erişim sağlar.Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.ThisAddIn sınıfının geri kalanı değiştirmemeniz gereken gizli bir kod dosyasında tanımlanmıştır.
ThisAddIn_Startup ve ThisAddIn_Shutdown olay işleyicileri.Bu olay işleyicileri, Word sizin eklentinizi yüklediğinde ve kaldırdığında çağırılır.Eklentiniz yüklendiğinde eklentinizi başlatmak ve kaldırıldığında eklentinizin kullandığı kaynakları temizlemek için bu olay işleyicilerini kullanın.Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.
Kaydedilmiş belgeye metnin bir paragrafını eklemek için
ThisAddIn kod dosyasında aşağıdaki kodu ThisAddIn sınıfına ekleyin.Yeni kod, belge kaydedildiğinde oluşan DocumentBeforeSave olayı için bir olay işleyicisi tanımlar.
Kullanıcı belgeyi kaydettiğinde, olay işleyicisi yeni metni belgenin başlangıcına ekler.
Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _ ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave Doc.Paragraphs(1).Range.InsertParagraphBefore() Doc.Paragraphs(1).Range.Text = "This text was added by using code." End Sub
void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel) { Doc.Paragraphs[1].Range.InsertParagraphBefore(); Doc.Paragraphs[1].Range.Text = "This text was added by using code."; }
[!NOT]
Bu kod, Paragraphs koleksiyonundaki ilk paragrafa erişmek için dizin değeri olarak 1'i kullanır.Visual Basic ve Visual C# sıfır tabanlı diziler kullanmasına rağmen Word nesne modelindeki birçok koleksiyonun en düşük dizi sınırı 1'dir.Daha fazla bilgi için bkz. Office Çözümlerinde Kod Yazma.
C# kullanıyorsanız, ThisAddIn_Startup olay işleyicisine aşağıdaki gerekli kodu ekleyin.Bu kod Application_DocumentBeforeSave olay işleyicisini DocumentBeforeSave olayı ile bağlamak için kullanılır.
this.Application.DocumentBeforeSave += new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
Belgeyi kaydedildiğinde değiştirmek için yukarıdaki kod örnekleri aşağıdaki nesneleri kullanır:
ThisAddIn sınıfının Application alanı.Application alanı, Word'ün geçerli örneğini gösteren Microsoft.Office.Interop.Word.Application nesnesi döner.
DocumentBeforeSave olayı işleyicisinin Doc parametresi.Doc parametresi, kaydedilmiş belgeyi temsil eden Microsoft.Office.Interop.Word.Document nesnesidir.Daha fazla bilgi için bkz. Word Nesne Modeline Genel Bakış.
Projeyi Test Etme
Projeyi test etmek için
Projeyi derlemek ve çalıştırmak için F5'a basın.
Projeyi derlediğinizde kod, projenin yapı çıktı klasörüne dahil edilen bir bütünleştirilmiş koda dönüşür.Visual Studio ayrıca Word'ün eklentiyi fark edip yükleyebilmesi için kayıt girdilerinden oluşan bir küme yaratır ve eklentinin çalışabilmesi için geliştirici bilgisayarının güvenlik ayarlarını yapılandırır.Daha fazla bilgi için bkz. Office çözümler oluşturma.
Word'de etkin belgeyi kaydedin.
Aşağıdaki metnin belgeye ekli olduğunu doğrulayın.
Bu metin kod kullanılarak eklenmiştir.
Word’ü kapatın.
Projeyi Temizleme
Projeyi geliştirmeyi bitirdiğinizde eklentinin bütünleştirilmiş kodunu, kayıt girdilerini ve güvenlik ayarlarını geliştirme bilgisayarınızdan kaldırın.Aksi halde, Word'ü geliştirme bilgisayarında her açtığınızda eklenti çalışmaya devam edecektir.
Geliştirici bilgisayarınızdaki tamamlanmış projeyi temizlemek için
- Visual Studio Build (Yapı) menüsünde Clean Solution'a (Çözümü Temizle) tıklayın.
Sonraki Adımlar
Word için temel bir uygulama düzeyi eklentisi oluşturduğunuza göre, eklentileri nasıl geliştireceğiniz hakkında daha fazlasını bu konulardan öğrenebilirsiniz:
Eklentiler kullanarak gerçekleştirebileceğiniz genel programlama görevleri: Uygulama Düzeyi Eklentileri Programlama.
Word eklentilerine özel programlama görevleri: Word Çözümleri.
Word nesne modelini kullanma: Word Nesne Modeline Genel Bakış.
Word UI'ını özelleştirme, örneğin, bunun Şerit'e özel bir sekme ekleme veya kendi özel görev bölmenizi oluşturma: Office UI Özelleştirme.
Word için uygulama düzeyi eklentilerde hata ayıklama ve oluşturma: Office çözümler oluşturma.
Word için uygulama düzeyi eklentileri dağıtma: Office Çözümünü Dağıtma.
Ayrıca bkz.
Kavramlar
Office Çözümleri Geliştirmesine Genel Bakış
Diğer Kaynaklar
Uygulama Düzeyi Eklentileri Programlama