İzlenecek yol: Word için ilk belge düzeyi özelleştirmenizi oluşturma

  • Makale

Bu giriş niteliğindeki kılavuzda, Microsoft Office Word için belge düzeyinde özelleştirmenin nasıl oluşturulacağı gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler yalnızca belirli bir belge açık olduğunda kullanılabilir. Uygulama genelinde değişiklikler yapmak için, örneğin herhangi bir belge açıkken yeni bir Şerit sekmesi görüntülemek için belge düzeyinde özelleştirme kullanamazsınız.

Şunlar için geçerlidir: Bu konudaki bilgiler Word için belge düzeyi projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

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

  • Word belgesi projesi oluşturma.

  • Visual Studio tasarımcısında barındırılan belgeye metin ekleme.

  • Word açıldığında özelleştirilmiş belgeye metin eklemek için nesne modelini kullanan kod yazma.

  • Test etmek için projeyi oluşturma ve çalıştırma.

  • Geliştirme bilgisayarınızdan gereksiz derleme dosyalarını ve 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 . IDE'yi kişiselleştirme.

Önkoşullar

Bu izlenecek yolu 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 sürümü. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.

  • Microsoft Word

Proje oluşturma

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

  1. Visual Studio’yu çalıştırın.

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

  3. Yeni Proje Oluştur iletişim kutusunda Word VSTO Belgesi projesini seçin.

    Not

    Yeni Proje Oluştur iletişim kutusunun üst kısmındaki Arama metin kutusuna Office ürününün adını yazarak da şablon arayabilirsiniz. Örneğin, Excel yazıldığında Excel için tüm proje şablonları gösterilir. Ayrıca, Proje türü açılan kutusunda Office'i seçerek şablon listesini yalnızca Office şablonlarını gösterecek şekilde filtreleyebilirsiniz. Daha fazla bilgi için bkz. Visual Studio'da yeni proje oluşturma.

  4. İleri'ye tıklayın.

  5. Yeni projenizi yapılandırın iletişim kutusundaki Ad kutusuna FirstWorkbookCustomization yazın ve Oluştur'a tıklayın.

  6. Office Proje sihirbazı için Visual Studio Araçları Yeni belge oluştur'u seçin ve Tamam'a tıklayı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ıda belgeyi kapatma ve yeniden açma

Projenizi geliştirirken belgeyi tasarımcıda bilerek veya yanlışlıkla kapatırsanız, belgeyi yeniden açabilirsiniz.

Tasarımcıda belgeyi kapatıp yeniden açmak için

  1. Tasarımcı penceresinin Kapat düğmesine (X) tıklayarak belgeyi kapatın.

  2. Çözüm Gezgini'de ThisDocument kod dosyasına sağ tıklayın ve Tasarım Aracı Görüntüle'ye tıklayın.

    - veya -

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

Tasarımcıda belgeye metin ekleme

Tasarımcıda açık olan belgeyi değiştirerek özelleştirmenizin kullanıcı arabirimini (UI) tasarlayabilirsiniz. Örneğin, metin, tablo veya Word denetimleri ekleyebilirsiniz. Tasarımcıyı kullanma hakkında daha fazla bilgi için bkz . Visual Studio ortamındaki Office projeleri.

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

  1. Tasarımcıda açık olan belgeye aşağıdaki metni yazın.

    Bu metin tasarımcı kullanılarak eklendi.

Belgeye program aracılığıyla metin ekleme

Ardından, ThisDocument kod dosyasına kod ekleyin. Yeni kod, belgeye ikinci bir metin paragrafı eklemek için Word'ün nesne modelini kullanır. Varsayılan olarak, ThisDocument kod dosyası aşağıdaki oluşturulan kodu içerir:

  • Belgenin ThisDocument programlama modelini temsil eden ve Word'ün nesne modeline erişim sağlayan sınıfın kısmi tanımı. Daha fazla bilgi için bkz. Belge konak öğesine ve Word nesne modeline genel bakış. Sınıfın ThisDocument geri kalanı, değiştirmemeniz gereken gizli bir kod dosyasında tanımlanır.

  • ThisDocument_Startup ve ThisDocument_Shutdown olay işleyicileri. Bu olay işleyicileri, belge açıldığında ve kapatıldığında çağrılır. Belge açıldığında özelleştirmenizi başlatmak ve belge kapatıldığı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 belgeye ikinci bir metin paragrafı eklemek için

  1. Çözüm Gezgini'da ThisDocument'a sağ tıklayın ve ardından Kodu Görüntüle'ye tıklayın.

    Kod dosyası Visual Studio'da açılır.

  2. Olay işleyicisini ThisDocument_Startup aşağıdaki kodla değiştirin. Belge açıldığında, bu kod belgeye ikinci bir metin paragrafı ekler.

    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, özelliğindeki ilk paragrafa Paragraphs erişmek için 1 dizin değerini kullanır. Visual Basic ve Visual C# 0 tabanlı diziler kullansa da, Word nesne modelindeki çoğu koleksiyonun alt dizi sınırları 1'dir. Daha fazla bilgi için bkz . Office çözümlerinde kod yazma.

Projeyi test etme

Belgenizi test etmek için

  1. Projenizi oluşturmak ve çalıştırmak için F5 tuşuna basın.

    Projeyi oluşturduğunuzda, kod belgeyle ilişkili bir derlemede derlenmiş. Visual Studio, belgenin ve derlemenin bir kopyasını projenin derleme çıktı klasörüne yerleştirir ve özelleştirmenin çalışmasını sağlamak için geliştirme bilgisayarındaki güvenlik ayarlarını yapılandırır. Daha fazla bilgi için bkz . Office çözümleri oluşturma.

  2. Belgede aşağıdaki metni gördüğünüzden emin olun.

    Bu metin tasarımcı kullanılarak eklendi.

    Bu metin kod kullanılarak eklendi.

  3. Belgeyi kapatın.

Projeyi temizleme

Proje geliştirmeyi bitirdiğinizde, derleme çıktı klasöründeki dosyaları ve derleme işlemi tarafından oluşturulan güvenlik ayarlarını kaldırmanız gerekir.

Geliştirme bilgisayarınızda tamamlanmış projeyi temizlemek için

  1. Visual Studio'da, Oluştur menüsünde Çözümü Temizle'ye tıklayın.

Sonraki adımlar

Word için temel bir belge düzeyinde özelleştirme oluşturduğunuza göre, şu konularda özelleştirme geliştirme hakkında daha fazla bilgi edinebilirsiniz:

  • Belge düzeyi özelleştirmelerinde gerçekleştirebileceğiniz genel programlama görevleri: Belge düzeyi özelleştirmelerini programla.

  • Word: Word çözümleri için belge düzeyi özelleştirmelerine özgü programlama görevleri.

  • Word'ün nesne modelini kullanma: Word nesne modeline genel bakış.

  • Örneğin, Şerit'e özel bir sekme ekleyerek veya kendi eylemlerinizi oluşturarak Word kullanıcı arabirimini özelleştirme: Office kullanıcı arabirimi özelleştirmesi.

  • 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 genişletilmiş Word nesnelerini kullanma (örneğin, belgelerde yönetilen denetimleri barındırma ve Windows Forms veri bağlama modelini kullanarak Word denetimlerini verilere bağlama): Genişletilmiş nesneleri kullanarak Word'i otomatikleştirin.

  • Word için belge düzeyi özelleştirmeleri oluşturma ve hata ayıklama: Office çözümleri oluşturma.

  • Word için belge düzeyi özelleştirmeleri dağıtma: Office çözümü dağıtma.

İlgili içerik