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

Makale
08/01/2011

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 2007 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 anlatım aşağıdaki görevleri gösterir:

Word eklenti projesi oluşturma.
Kaydedildiğinde belgeye metin eklemek için Word nesne modelini kullanan kod yazma.
Sınamak 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. 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 anlatımı tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2010 sürümü. Daha fazla bilgi için bkz: [Office Çözümeri Geliştirmek İçin Bilgisayarı Yapılandırma](bb398242\(v=vs.100\).md).

Word 2007 veya Word 2010.

Projeyi Oluşturma

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

Visual Studio uygulamasını başlatın.
File (Dosya) menüsünde, New'un (Yeni) üzerine gelin ve Project'i (Proje) tıklatın.
Şablon bölmesinde Visual C# veya Visual Basic'i genişletin ve sonra Office'i genişletin.
Genişletilmiş Office düğümünde Word 2007 yüklü ise 2007'ı veya Word 2010 yüklüyse 2010'i seçin.
Proje şablonları listesinde Word 2007 Eklentisi'ni ya da Word 2010 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. Visual Basic vb. ile Programlama Office Çözümlerinde Visual C#.
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 Sınama

Projeyi sınamak için

Projeyi derlemek ve çalıştırmak için F5'e 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 Yapı İşlemine Genel Bakış.
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 Şerit'e özel bir sekme ekleme veya kendi özel görev bölmenizi oluşturma: Office UI Özelleştirmesi.
Word için uygulama düzeyi eklentileri derleme ve hataları ayıklama: Office Çözümlerini Oluşturma ve Hatalarını Ayıklama.
Word için uygulama düzeyi eklentileri dağıtma: Office Çözümlerini Dağıtma.