Bagikan melalui

Panduan: Membuat kustomisasi tingkat dokumen pertama Anda untuk Word

  • Artikel

Panduan pengantar ini memperlihatkan kepada Anda cara membuat kustomisasi tingkat dokumen untuk Microsoft Office Word. Fitur yang Anda buat dalam solusi semacam ini hanya tersedia saat dokumen tertentu terbuka. Anda tidak dapat menggunakan kustomisasi tingkat dokumen untuk membuat perubahan di seluruh aplikasi, misalnya, menampilkan tab Pita baru saat dokumen apa pun terbuka.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen untuk Word. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

  • Membuat proyek dokumen Word.

  • Menambahkan teks ke dokumen yang dihosting di perancang Visual Studio.

  • Menulis kode yang menggunakan model objek Word untuk menambahkan teks ke dokumen yang dikustomisasi saat dibuka.

  • Membangun dan menjalankan proyek untuk mengujinya.

  • Membersihkan proyek untuk menghapus file build dan setelan keamanan yang tidak perlu dari komputer pengembangan Anda.

    Catatan

    Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

Membuat proyek

Untuk membuat proyek dokumen Word baru di Visual Studio

  1. Mulai Visual Studio.

  2. Pada menu File, arahkan ke Baru, lalu klik Proyek.

  3. Pada dialog Buat Proyek Baru pilih proyek Dokumen Word VSTO.

    Catatan

    Anda juga bisa mencari templat dengan mengetik nama produk Office di kotak teks Pencarian di bagian atas dialog Buat Proyek Baru. Misalnya, mengetik Excel akan memperlihatkan kepada Anda semua templat proyek untuk Excel. Anda juga bisa memfilter daftar templat untuk memperlihatkan hanya templat untuk Office dengan memilih Office di kotak dropdown Jenis proyek. Untuk informasi selengkapnya, lihat Membuat proyek baru di Visual Studio.

  4. Klik Berikutnya.

  5. Ketik FirstWorkbookCustomization di kotak Nama pada dialog Konfigurasikan proyek baru Anda dan klik Buat.

  6. Pilih Buat dokumen baru dari Wizard Visual Studio Tools for Office Project, dan klik OK.

    • Visual Studio membuat proyek FirstDocumentCustomization , dan menambahkan dokumen FirstDocumentCustomization dan file kode ThisDocument ke proyek. Dokumen FirstDocumentCustomization dibuka secara otomatis di perancang.

Tutup dan buka kembali dokumen dalam perancang

Jika Anda sengaja atau tidak sengaja menutup dokumen di perancang saat mengembangkan proyek, Anda dapat membukanya kembali.

Untuk menutup dan membuka kembali dokumen di perancang

  1. Tutup dokumen dengan mengklik tombol Tutup (X) untuk jendela perancang.

  2. Di Penjelajah Solusi, klik kanan file kode ThisDocument, dan klik Tampilkan Perancang.

    - atau -

    Di Penjelajah Solusi, klik dua kali file kode ThisDocument.

Menambahkan teks ke dokumen dalam perancang

Anda dapat merancang antarmuka pengguna (UI) kustomisasi Anda dengan memodifikasi dokumen yang terbuka di perancang. Misalnya, Anda bisa menambahkan kontrol teks, tabel, atau Word. Untuk informasi selengkapnya tentang cara menggunakan perancang, lihat Proyek Office di lingkungan Visual Studio.

Untuk menambahkan teks ke dokumen Anda dengan menggunakan perancang

  1. Dalam dokumen yang terbuka di perancang, ketik teks berikut.

    Teks ini ditambahkan dengan menggunakan perancang.

Menambahkan teks ke dokumen secara terprogram

Selanjutnya, tambahkan kode ke file kode ThisDocument. Kode baru menggunakan model objek Word untuk menambahkan paragraf teks kedua ke dokumen. Secara default, file kode ThisDocument berisi kode yang dihasilkan berikut:

  • Definisi ThisDocument parsial kelas, yang mewakili model pemrograman dokumen dan menyediakan akses ke model objek Word. Untuk informasi selengkapnya, lihat Item host dokumen dan gambaran umum model objek Word. ThisDocument Sisa kelas ditentukan dalam file kode tersembunyi yang tidak boleh Anda ubah.

  • Penanganan ThisDocument_Startup aktivitas dan ThisDocument_Shutdown . Penanganan aktivitas ini dipanggil ketika dokumen dibuka dan ditutup. Gunakan penanganan aktivitas ini untuk menginisialisasi kustomisasi Anda saat dokumen dibuka, dan untuk membersihkan sumber daya yang digunakan oleh kustomisasi Anda saat dokumen ditutup. Untuk informasi selengkapnya, lihat Peristiwa di proyek Office.

Untuk menambahkan paragraf kedua teks ke dokumen dengan menggunakan kode

  1. Di Penjelajah Solusi, klik kanan ThisDocument, lalu klik Tampilkan Kode.

    File kode terbuka di Visual Studio.

  2. Ganti penanganan ThisDocument_Startup aktivitas dengan kode berikut. Saat dokumen dibuka, kode ini menambahkan paragraf teks kedua ke dokumen.

    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.";
}

    Catatan

    Kode ini menggunakan nilai indeks 1 untuk mengakses paragraf pertama dalam Paragraphs properti . Meskipun Visual Basic dan Visual C# menggunakan array berbasis 0, batas array yang lebih rendah dari sebagian besar koleksi dalam model objek Word adalah 1. Untuk informasi selengkapnya, lihat Menulis kode di solusi Office.

Menguji proyek

Untuk menguji dokumen Anda

  1. Tekan F5 untuk membangun dan menjalankan proyek Anda.

    Saat Anda membuat proyek, kode dikompilasi ke dalam rakitan yang terkait dengan dokumen. Visual Studio menempatkan salinan dokumen dan perakitan di folder output build untuk proyek, dan mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk mengaktifkan penyesuaian untuk dijalankan. Untuk informasi selengkapnya, lihat Membangun solusi Office.

  2. Dalam dokumen, verifikasi bahwa Anda melihat teks berikut.

    Teks ini ditambahkan dengan menggunakan perancang.

    Teks ini ditambahkan dengan menggunakan kode.

  3. Tutup dokumen.

Membersihkan proyek

Setelah selesai mengembangkan proyek, Anda harus menghapus file di folder output build dan pengaturan keamanan yang dibuat oleh proses build.

Untuk membersihkan proyek yang telah selesai pada komputer pengembangan Anda

  1. Di Visual Studio, pada menu Build , klik Bersihkan Solusi.

Langkah berikutnya

Sekarang setelah Anda membuat kustomisasi tingkat dokumen dasar untuk Word, Anda bisa mempelajari selengkapnya tentang cara mengembangkan kustomisasi dari topik ini:

  • Tugas pemrograman umum yang dapat Anda lakukan dalam kustomisasi tingkat dokumen: Kustomisasi tingkat dokumen program.

  • Tugas pemrograman yang khusus untuk kustomisasi tingkat dokumen untuk Word: Solusi Word.

  • Menggunakan model objek Word: Gambaran umum model objek Word.

  • Mengkustomisasi UI Word, misalnya, dengan menambahkan tab kustom ke pita atau membuat panel tindakan Anda sendiri: Kustomisasi Office UI.

  • Menggunakan objek Word yang diperluas yang disediakan oleh solusi Office di Visual Studio untuk melakukan tugas yang tidak dimungkinkan dengan menggunakan model objek Word (misalnya, menghosting kontrol terkelola pada dokumen dan mengikat kontrol Word ke data dengan menggunakan model pengikatan data Formulir Windows): Mengotomatiskan Word dengan menggunakan objek yang diperluas.

  • Membangun dan men-debug kustomisasi tingkat dokumen untuk Word: Membangun solusi Office.

  • Menyebarkan kustomisasi tingkat dokumen untuk Word: Menyebarkan solusi Office.

Konten terkait