İzlenecek yol: İlk belge düzeyinde özeleştirme sözcük oluşturma
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 2013 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 ö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ı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 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. 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. 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ümler 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 UI Ö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ümler oluşturma.
Word için belge düzeyi özelleştirmelerini dağıtma: Office Çözümünü Dağıtma.
Ayrıca bkz.
Kavramlar
Office Çözümleri Geliştirmesine Genel Bakış
Genişletilmiş Nesneleri Kullanarak Word'ü Otomatikleştirme
Diğer Kaynaklar
Belge Düzeyi Özelleştirmelerini Programlama