Gambaran umum model objek Word
Saat Anda mengembangkan solusi Word di Visual Studio, Anda berinteraksi dengan model objek Word. Model objek ini terdiri dari kelas dan antarmuka yang disediakan dalam perakitan interop utama untuk Word, dan didefinisikan dalam Microsoft.Office.Interop.Word namespace layanan.
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.
Topik ini memberikan gambaran singkat tentang model objek Word. Untuk sumber daya di mana Anda bisa mempelajari selengkapnya tentang seluruh model objek Word, lihat Menggunakan dokumentasi model objek Word.
Untuk informasi tentang menggunakan model objek Word untuk melakukan tugas tertentu, lihat topik berikut ini:
Memahami model objek Word
Word menyediakan ratusan objek yang bisa Anda berinteraksi. Objek-objek ini diatur dalam hierarki yang sangat mengikuti antarmuka pengguna. Di bagian atas hierarki adalah Application objek . Objek ini mewakili contoh Word saat ini. Objek Application berisi Documentobjek , , SelectionBookmark, dan Range . Masing-masing objek ini memiliki banyak metode dan properti yang dapat Anda akses untuk memanipulasi dan berinteraksi dengan objek.
Ilustrasi berikut ini memperlihatkan satu tampilan objek ini dalam hierarki model objek Word.
Sekilas, objek tampak tumpang tindih. Misalnya, Document objek dan Selection adalah kedua anggota Application objek, tetapi Document objek juga merupakan anggota Selection objek. Document Objek dan Selection berisi Bookmark objek dan Range . Tumpang tindih ada karena ada beberapa cara Anda dapat mengakses jenis objek yang sama. Misalnya, Anda menerapkan pemformatan ke Range objek; tetapi Anda mungkin ingin mengakses rentang pilihan saat ini, dari paragraf tertentu, bagian, atau seluruh dokumen.
Bagian berikut ini secara singkat menjelaskan objek tingkat atas dan bagaimana mereka berinteraksi satu sama lain. Objek-objek ini mencakup lima hal berikut:
Objek aplikasi
Objek dokumen
Objek pilihan
Objek rentang
Objek marka buku
Selain model objek Word, proyek Office di Visual Studio menyediakan item host dan kontrol host yang memperluas beberapa objek dalam model objek Word. Item host dan kontrol host berpura-pura seperti objek Word yang diperluas, tetapi mereka juga memiliki fungsionalitas tambahan seperti kemampuan pengikatan data dan peristiwa tambahan. Untuk informasi selengkapnya, lihat Mengotomatiskan Word dengan menggunakan objek yang diperluas dan Gambaran umum item host dan kontrol host.
Objek aplikasi
Objek Application mewakili aplikasi Word, dan merupakan induk dari semua objek lainnya. Anggotanya biasanya berlaku untuk Word secara keseluruhan. Anda bisa menggunakan properti dan metodenya untuk mengontrol lingkungan Word.
Dalam proyek Add-in VSTO, Anda dapat mengakses Application objek dengan menggunakan Application bidang ThisAddIn kelas . Untuk informasi selengkapnya, lihat Add-in VsTO Program.
Dalam proyek tingkat dokumen, Anda dapat mengakses Application objek dengan menggunakan Application properti ThisDocument kelas .
Objek dokumen
Objek Document ini terpusat untuk memprogram Word. Ini mewakili dokumen dan semua kontennya. Saat Anda membuka dokumen atau membuat dokumen baru, Anda membuat objek baru Document , yang ditambahkan ke Documents kumpulan Application objek. Dokumen yang memiliki fokus disebut dokumen aktif. Ini diwakili oleh ActiveDocument properti Application objek.
Alat pengembangan Office di Visual Studio memperluas Document objek dengan menyediakan jenisnya Document . Jenis ini adalah item host yang memberi Anda akses ke semua fitur Document objek, dan menambahkan peristiwa tambahan dan kemampuan untuk menambahkan kontrol terkelola.
Saat membuat proyek tingkat dokumen, Anda dapat mengakses Document anggota dengan menggunakan kelas yang dihasilkan ThisDocument dalam proyek Anda. Anda dapat mengakses anggota Document item host dengan menggunakan Saya atau kata kunci ini dari kode di ThisDocument kelas, atau dengan menggunakan Globals.ThisDocument dari kode di luar ThisDocument kelas. Untuk informasi selengkapnya, lihat Kustomisasi tingkat dokumen program. Misalnya, untuk memilih paragraf pertama dalam dokumen, gunakan kode berikut.
Di proyek Add-in VSTO, Anda dapat menghasilkan Document item host pada waktu proses. Anda dapat menggunakan item host yang dihasilkan untuk menambahkan kontrol ke dokumen terkait. Untuk informasi selengkapnya, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.
Objek pilihan
Objek Selection mewakili area yang saat ini dipilih. Saat Anda melakukan operasi di antarmuka pengguna Word, seperti menebalkan teks, Anda memilih, atau menyorot teks lalu menerapkan pemformatan. Objek Selection selalu ada dalam dokumen. Jika tidak ada yang dipilih, maka itu mewakili titik penyisipan. Selain itu, pilihan dapat mencakup beberapa blok teks yang tidak berdekatan.
Objek rentang
Objek Range mewakili area yang berdekatan dalam dokumen, dan didefinisikan oleh posisi karakter awal dan posisi karakter akhir. Anda tidak terbatas pada satu Range objek. Anda dapat menentukan beberapa Range objek dalam dokumen yang sama. Objek Range memiliki karakteristik berikut:
Ini dapat terdiri dari titik penyisipan saja, rentang teks, atau seluruh dokumen.
Ini termasuk karakter non-pencetakan seperti spasi, karakter tab, dan tanda paragraf.
Ini bisa menjadi area yang diwakili oleh pilihan saat ini, atau dapat mewakili area yang berbeda dari pilihan saat ini.
Ini tidak terlihat dalam dokumen, tidak seperti pilihan, yang selalu terlihat.
Ini tidak disimpan dengan dokumen dan hanya ada saat kode sedang berjalan.
Saat Anda menyisipkan teks di akhir rentang, Word secara otomatis memperluas rentang untuk menyertakan teks yang disisipkan.
Objek kontrol konten
Menyediakan ContentControl cara bagi Anda untuk mengontrol input dan presentasi teks dan tipe konten lainnya dalam dokumen Word. Bisa ContentControl menampilkan beberapa tipe UI berbeda yang dioptimalkan untuk digunakan dalam dokumen Word, seperti kontrol teks kaya, pemilih tanggal, atau kotak kombo. Anda juga dapat menggunakan ContentControl untuk mencegah pengguna mengedit bagian dokumen atau templat.
Visual Studio memperluas ContentControl objek ke dalam beberapa kontrol host yang berbeda. ContentControl Sedangkan objek dapat menampilkan salah satu dari berbagai jenis UI yang tersedia untuk kontrol konten, Visual Studio menyediakan jenis yang berbeda untuk setiap kontrol konten. Misalnya, Anda dapat menggunakan RichTextContentControl untuk membuat kontrol teks kaya, atau Anda dapat menggunakan DatePickerContentControl untuk membuat pemilih tanggal. Kontrol host ini berperilaku seperti asli ContentControl, tetapi mereka memiliki peristiwa tambahan dan kemampuan pengikatan data. Untuk informasi selengkapnya, lihat Kontrol konten.
Objek marka buku
Objek Bookmark mewakili area yang berdampingan dalam dokumen, dengan posisi awal dan posisi akhir. Anda bisa menggunakan marka buku untuk menandai lokasi dalam dokumen, atau sebagai kontainer untuk teks dalam dokumen. Objek Bookmark dapat terdiri dari titik penyisipan, atau sebesar seluruh dokumen. A Bookmark memiliki karakteristik berikut yang membedakannya dari Range objek:
Anda dapat memberi nama bookmark pada waktu desain.
Bookmark objek disimpan dengan dokumen, dan dengan demikian tidak dihapus ketika kode berhenti berjalan atau dokumen Anda ditutup.
Marka buku dapat disembunyikan atau dibuat terlihat dengan mengatur ShowBookmarks properti View objek ke false atau true.
Visual Studio memperluas Bookmark objek dengan menyediakan Bookmark kontrol host. Bookmark Kontrol host berperilaku seperti asli Bookmark, tetapi memiliki peristiwa tambahan dan kemampuan pengikatan data. Anda dapat mengikat data ke kontrol marka buku pada dokumen dengan cara yang sama seperti Anda mengikat data ke kontrol kotak teks pada Formulir Windows. Untuk informasi selengkapnya, lihat Kontrol bookmark.
Menggunakan dokumentasi model objek Word
Untuk informasi lengkap tentang model objek Word, Anda bisa merujuk ke referensi perakitan interop utama Word (PIA) dan referensi model objek Visual Basic for Applications (VBA).
Referensi perakitan interop utama
Dokumentasi referensi Word PIA menjelaskan tipe dalam rakitan interop utama untuk Word. Dokumentasi ini tersedia dari lokasi berikut: Referensi perakitan interop utama Word 2010.
Untuk informasi selengkapnya tentang desain Word PIA, seperti perbedaan antara kelas dan antarmuka di PIA dan bagaimana peristiwa di PIA diterapkan, lihat Gambaran umum kelas dan antarmuka di rakitan interop utama Office.
Referensi model objek VBA
Model objek VBA mereferensikan dokumen model objek Word saat diekspos ke kode VBA. Untuk informasi selengkapnya, lihat Referensi model objek Word 2010.
Semua objek dan anggota dalam referensi model objek VBA sesuai dengan jenis dan anggota di Word PIA. Misalnya, objek Dokumen dalam referensi model objek VBA sesuai dengan Document objek di Word PIA. Meskipun referensi model objek VBA menyediakan contoh kode untuk sebagian besar properti, metode, dan peristiwa, Anda harus menerjemahkan kode VBA dalam referensi ini ke Visual Basic atau Visual C# jika Anda ingin menggunakannya dalam proyek Word yang Anda buat dengan menggunakan Visual Studio.