İzlenecek Yol: Word için İlk Belge Düzeyi Özelleştirmenizi Oluşturma

Makale
08/01/2011

Bu tanıtıcı izlenecek yollar, Microsoft Office Word için belge düzeyi özelleştirmesinin nasıl oluşturulduğunu gösterir. Bu tarz çözümde oluşturduğunuz özellikler sadece belirli bir dosya açıkken kullanılabilir. Belge düzeyi özelleştirmelerini uygulama çapında değişiklik yapmak için kullanamazsınız, örneğin herhangi bir belge açıkken yeni bir Şerit sekmesi görüntüleme gibi.

Uygulama alanı: Bu konudaki bilgiler Word 2007 ve Word 2010 uygulamalarının belge düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Bu izlenecek yol aşağıdaki görevleri gösterir:

Word belgesi projesi oluşturma.
Visual Studio tasarımcısında olan belgeye metin ekleme.
Açıldığında özelleştirilmiş belgeye metin eklemek için Word nesne modelini kullanan kod yazma.
Test etmek için projeyi oluşturma ve çalıştırma.
Gereksiz yapı dosyalarını ve geliştirme bilgisayarından güvenlik ayarlarını kaldırmak için projeyi 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 belge 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 Belge'sini veya Word 2010 Belge'sini seçin.
Name (Ad) metin kutusuna FirstDocumentCustomization yazın.
Tamam düğmesini tıklatın.

Office için Visual Studio Araçları Sihirbaz'ı açılır.
Yeni belge oluştur'u seçin ve Tamam'ı tıklatın.

Visual Studio FirstDocumentCustomization projesini oluşturur ve FirstDocumentCustomization belgesini ve ThisDocument kod dosyasını projeye ekler. FirstDocumentCustomization belgesi tasarımcıda otomatik olarak açılır.

Tasarımcıdaki Belgeyi Kapatma ve Yeniden Açma

Projenizi geliştirirken kasıtlı olarak veya kazara tasarımcıdaki belgeyi kapatırsanız, belgeyi yeniden açabilirsiniz.

Tasarımcıdaki belgeyi kapatmak ve yeniden açmak için

Tasarımcı penceresinin Close (X) düğmesine tıklayarak belgeyi kapatın.
Solution Explorer'da (Çözüm Gezgini) ThisDocument kod dosyasını sağ tıklayın ve View Designer'a (Görünüm Tasarımcısı) tıklayın.

- veya -

Çözüm Gezgini'nde ThisDocument kod dosyasına çift tıklayın.

Tasarımcıdaki Belgeye Metin Ekleme

Özelleştirmenizin kullanıcı arabirimini (KA) tasarımcıda açık olan belgeyi değiştirerek tasarlayabilirsiniz. Örneğin, metin, tablo veya Word denetimleri ekleyebilirsiniz. Tasarımcının nasıl kullanılacağı hakkında daha fazla bilgi için bkz. Visual Studio Ortamında Office Projeleri.

Tasarımcıyı kullanarak belgenize metin eklemek için

Tasarımcıda açık olan belgenin içine aşağıdaki metni yazın.

Bu metin tasarımcı kullanılarak eklenmiştir.

Program Aracılığıyla Belgeye Metin Ekleme

Sonra, kodu ThisDocument kod dosyasına ekleyin. Yeni kod, metnin ikinci paragrafını belgeye eklemek için Word nesne modelini kullanır. Varsayılan olarak ThisDocument kod dosyası aşağıdaki oluşturulmuş kodu içerir:

Belgenin programlama modelini gösteren ve Word nesne modeline erişimini sağlayan ThisDocument sınıfının kısmi tanımıdır. Daha fazla bilgi için, bkz. Document (Belge) Konak Öğesi ve Word Nesne Modeline Genel Bakış. ThisDocument sınıfının geri kalanı değiştirmemeniz gereken gizli bir kod dosyasında tanımlanmıştır.
ThisDocument_Startup ve ThisDocument_Shutdown olay işleyicileri. Bu olay işleyicileri belge açıldığında ve kapandığında çağırılırlar. Belge açıldığında özelleştirmelerinizi başlatmak ve kapandığında özelleştirmeniz tarafından kullanılan kaynakları temizlemek için bu olay işleyicilerini kullanın. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.

Kod kullanarak metnin ikinci paragrafını belgeye eklemek için

Solution Explorer'da (Çözüm Gezgini) ThisDocument'a sağ tıklayın ve ardından View Code'u (Kodu Göster) tıklayın.

Kod dosyası Visual Studio'da açılır.
ThisDocument_Startup olay işleyicisini aşağıdaki kod ile değiştirin. Belge açıldığında bu kod metnin ikinci paragrafını belgeye ekler.
```
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub
```
```
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}
```
Not

Bu kod, Paragraphs özelliğindeki 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#.

Projeyi Test Etme

Belgenizi test etmek için

Projeyi derlemek ve çalıştırmak için F5'a basın.

Projeyi derlediğinizde kod belgeyle ilişkilendirilen bir derleyiciye derlenir. Visual Studio belgenin ve derleyicinin kopyasını yapı çıktı dosyasına koyar ve özelleştirmenin çalışması 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ış.
Belgede aşağıdaki metni gördüğünüzü doğrulayın.

Bu metin tasarımcı kullanılarak eklenmiştir.

Bu metin kod kullanılarak eklenmiştir.
Belgeyi kapatın.

Projeyi Temizleme

Projeyi geliştirmeyi bitirdiğinizde yapı çıktı klasöründeki dosyaları ve yapı işlemi tarafından oluşturulmuş güvenlik ayarlarını kaldırmalısınız.

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 basit belge düzeyi özelleştirmesi oluşturdunuz, özelleştirmeleri nasıl geliştireceğiniz hakkında daha fazlasını bu konulardan öğrenebilirsiniz:

Belge düzeyi özelleştirmelerinde gerçekleştirebileceğiniz genel programlama görevleri: Belge Düzeyi Özelleştirmelerini Programlama.
Word belge düzeyi özelleştirmelerine özel programlama görevleri: Word Çözümleri.
Word nesne modelini kullanma: Word Nesne Modeline Genel Bakış.
Word'ün KA'ni özelleştirme, örneğin Şerit'e özel bir sekme ekleme veya kendi eylem bölmenizi oluşturma: Office UI Özelleştirmesi.
Word nesne modelini kullanarak mümkün olmayan görevleri (örneğin, belgelerdeki yönetilen denetimleri yönetme, Windows Forms veri bağlama modelini kullanarak veriye Word denetimi bağlama) gerçekleştirmek üzere Visual Studio Tools for Office tarafından sağlanan genişletilmiş Word nesnelerini kullanma: Genişletilmiş Nesneleri Kullanarak Word'ü Otomatikleştirme.
Word için belge düzeyi özelleştirmelerini derleme ve hata ayıklama: Office Çözümlerini Oluşturma ve Hatalarını Ayıklama.
Word için belge düzeyi özelleştirmelerini dağıtma: Office Çözümlerini Dağıtma.