Item host dokumen
Item Document host adalah jenis yang memperluas Document jenis dari rakitan interop utama untuk Word. Item Document host menyediakan semua properti, metode, dan peristiwa yang sama sebagai Document objek, tetapi juga mengekspos peristiwa tambahan dan bertindak sebagai kontainer untuk kontrol host dan kontrol Formulir Windows.
Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk Word. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.
Dalam proyek tingkat dokumen, ada item host default Document yang mewakili dokumen dalam proyek Anda. Di proyek Add-in VSTO, Anda dapat menghasilkan Document item host pada waktu proses.
Memahami item host dokumen dalam proyek tingkat dokumen
Untuk mengakses dokumen di proyek Anda, gunakan ThisDocument kelas . Saat Anda membuat proyek tingkat dokumen, Visual Studio menghasilkan ThisDocument kelas untuk berfungsi sebagai tautan komunikasi antara Word dan kode kustomisasi Anda. Kelas memberi ThisDocument Anda akses ke anggota Document item host untuk melakukan tugas dasar dalam penyesuaian Anda, seperti menjalankan kode saat dokumen dibuka atau ditutup. Anda juga dapat menggunakan kelas untuk menambahkan kontrol ke dokumen. Dengan menggabungkan serangkaian kontrol yang berbeda dan menulis kode, Anda dapat mengikat kontrol ke data, mengumpulkan informasi dari pengguna, dan menanggapi tindakan pengguna. Untuk informasi selengkapnya, lihat Kustomisasi tingkat dokumen program.
Kelas ThisDocument ini menyediakan lokasi di mana Anda dapat mulai menulis kode dalam proyek Anda. Karena kelas menyediakan semua properti, metode, dan peristiwa yang sama dengan Document objek di rakitan interop utama untuk Word, Anda juga dapat menggunakan ThisDocument untuk mengakses model objek Word. Untuk informasi selengkapnya, lihat Gambaran umum model objek Word.
Batasan item host dokumen dalam proyek tingkat dokumen
Proyek tingkat dokumen hanya dapat berisi satu Document item host (yaitu, ThisDocument kelas ). Anda tidak dapat menambahkan item host baru Document ke proyek Anda pada waktu desain, dan Anda tidak dapat membuat item host baru Document pada waktu proses dari penyesuaian tingkat dokumen.
Jika Anda membuat dokumen Word baru pada waktu proses, dokumen tersebut akan berjenis Document. Karena bukan item host, item tidak boleh berisi kontrol host atau kontrol Formulir Windows. Untuk informasi selengkapnya tentang membuat dokumen pada waktu proses, lihat Cara: Membuat dokumen baru secara terprogram.
Memahami item host dokumen dalam proyek tingkat aplikasi
Di proyek Add-in VSTO, Anda bisa membuat Document item host pada waktu proses untuk dokumen apa pun yang terbuka di Word. Anda dapat menggunakan Document item host untuk menambahkan kontrol ke dokumen terkait, atau untuk menangani peristiwa yang tidak tersedia pada Document objek.
Untuk menghasilkan Document item host, gunakan GetVstoObject metode . Untuk informasi selengkapnya, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.