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

Makale
06/10/2015

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

Microsoft Office geliştirici araçlarını içeren bir Visual Studio 2013 sürümü. Daha fazla bilgi edinmek için, bkz. Office Çözümleri Geliştirmek İçin Bilgisayarı Yapılandırma.
Word 2013 veya Word 2010.

Projeyi Oluşturma

Visual Studio'da yeni Word belge 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 Belge'sini veya Word 2013 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. 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. Office Çözümlerinde Kod Yazma.

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 Oluşturma.
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 için belge düzeyi özelleştirmelerine ö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 eylem bölmenizi oluşturma: Office Kullanıcı Arabirimini Özelleştirme.
Genişletilmiş (örneğin, belgelerdeki yönetilen denetimleri yönetme ve Windows Forms veri bağlama modelini kullanarak veriye Word denetimi bağlama) Word nesne modelini kullanarak mümkün olmayan görevleri gerçekleştirmek için Visual Studio'da Office çözümleri tarafından sağlanan Word nesnelerini kullanma: Genişletilmiş Nesneleri Kullanarak Word'ü Otomatikleştirme.
Derleme ve hata ayıklama Word için belge düzeyi özelleştirmeleri: Office Çözümleri Oluşturma.
Word için belge düzeyi özelleştirmelerini dağıtma: Office Çözümünü Dağıtma.