Aracılığıyla paylaş

İzlenecek Yol: Word İçin İlk Uygulama Düzeyi Eklentiyi Oluşturma

  • Makale

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 hedefi: Bu konudaki bilgiler, Word 2013 ve Word 2010 için 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.

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ız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazıları için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için, bkz. Visual Studio'da Geliştirme Ayarlarını özelleştirme.

Önkoşullar

Bu örneği tamamlamak için aşağıdaki bileşenler gerekmektedir:

Projeyi Oluşturma

Visual Studio'da yeni Word eklenti projesi oluşturmak için

  1. Visual Studio uygulamasını başlatın.

  2. Dosya menüsünde, Yeni'nin üzerine gelin ve Proje'ye tıklatın.

  3. Şablonlar bölmesinde genişletin Visual C# veya Visual Basicve sonra genişletin Office/SharePoint.

  4. Genişletilmiş altında Office/SharePoint düğümü, select Office eklentileri düğümü.

  5. Proje şablonları listesinde Word 2010 Eklentisi'ni ya da Word 2013 Eklentisi'ni seçin.

  6. Ad kutusuna, FirstWordAddIn yazın.

  7. 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

  1. 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.

  2. 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:

Projeyi Test Etme

Projeyi test etmek için

  1. 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ümleri Oluşturma.

  2. Word'de etkin belgeyi kaydedin.

  3. Aşağıdaki metnin belgeye ekli olduğunu doğrulayın.

    Bu metin kod kullanılarak eklenmiştir.

  4. 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:

Ayrıca bkz.

Kavramlar

Office Çözümleri Geliştirmesine Genel Bakış

Diğer Kaynaklar

Word Çözümleri

Uygulama Düzeyi Eklentileri Programlama

Word Nesne Modeline Genel Bakış

Office Kullanıcı Arabirimini Özelleştirme

Office Çözümleri Oluşturma

Office Çözümünü Dağıtma

Office Proje Şablonlarına Genel Bakış