Persyaratan: Gunakan VSTO untuk mengembangkan plug-in sederhana untuk Office, seperti mendapatkan plug-in panjang karakter Word Chinese.
Model objek Word
Word menawarkan ratusan objek untuk berinteraksi. Objek-objek ini diatur dalam hierarki yang secara ketat mengikuti antarmuka pengguna. Objek Aplikasi berada di bagian atas hierarki. Objek ini mewakili instans Word saat ini. Objek Aplikasi berisi objek Dokumen, Seleksi, Bookmark, dan Rentang. Masing-masing objek ini memiliki sejumlah metode dan properti yang dapat digunakan untuk memanipulasi dan berinteraksi dengan objek.
Gambar berikut menunjukkan tampilan objek ini dalam hierarki model objek Word.
Dokumentasi:Login hyperlink terlihat.
Objek aplikasi
Objek Aplikasi mewakili aplikasi Word dan merupakan induk dari semua objek lainnya. Anggotanya biasanya diterapkan pada Word secara keseluruhan. Anda dapat menggunakan properti dan metodenya untuk mengontrol lingkungan Word.
Dalam proyek add-in VSTO, Anda dapat mengakses objek ThisAddIn dengan menggunakan bidang Aplikasi dari kelas Aplikasi.
Dalam proyek tingkat dokumen, objek ThisDocument dapat diakses dengan menggunakan properti Application dari kelas Application.
Objek dokumen
Objek Document adalah pusat pemrograman Word. Ini mewakili dokumen dan semua isinya. Saat Anda membuka dokumen atau membuat dokumen baru, objek Dokumen baru dibuat dan ditambahkan ke koleksi Aplikasi objek Dokumen. Dokumen dengan fokus dikenal sebagai dokumen aktif. Ini diwakili oleh properti Application dari objek ActiveDocument.
Saat membuat proyek tingkat dokumen, Anda dapat mengakses anggota ThisDocument dengan menggunakan kelas Document yang dihasilkan dalam proyek. Objek ThisDocument dapat diakses dengan menggunakan kata kunci Me atau this untuk kode di kelas Document, atau dengan menggunakan Globals.ThisDocument untuk kode di luar kelas ThisDocument.
Objek seleksi
Objek Selection mewakili wilayah yang saat ini dipilih. Saat melakukan tindakan di antarmuka pengguna Word, seperti teks tebal, Anda dapat memilih atau menyorot teks, lalu menerapkan pemformatan. Objek Selection selalu ada dalam dokumen. Jika tidak ada yang dicentang, itu menunjukkan titik penyisipan. Selain itu, konten yang dipilih dapat berisi beberapa blok teks yang tidak berdekatan.
Objek rentang
Objek Rentang mewakili area yang berdekatan dalam dokumen dan ditentukan oleh posisi karakter awal dan akhir. Ini tidak terbatas pada satu objek Rentang. Anda dapat menentukan beberapa objek Rentang dalam dokumen yang sama. Objek rentang memiliki karakteristik sebagai berikut:
- Ini hanya dapat berisi titik penyisipan individual, atau dapat berisi rentang teks atau seluruh dokumen.
- Ini mencakup karakter yang tidak dicetak seperti spasi, tab, dan penanda paragraf.
- Ini bisa berupa area yang diwakili oleh konten yang saat ini dipilih atau area yang berbeda dari konten ini.
- Itu tidak terlihat dalam dokumen, tidak seperti konten yang dipilih, yang selalu terlihat.
- Itu tidak disimpan dengan dokumentasi dan hanya ada saat kode sedang berjalan.
- Saat teks disisipkan di akhir rentang, Word secara otomatis memperluas rentang untuk menyertakan teks yang disisipkan.
Objek Kontrol Konten (Objek Kontrol Konten)
ContentControl menyediakan cara untuk mengontrol input dan rendering teks dan jenis konten lainnya dalam dokumen Word. ContentControl dapat menampilkan berbagai jenis UI yang dioptimalkan untuk digunakan dalam dokumen Word, seperti kontrol teks multi-pesan, pemilih tanggal, atau kotak kombo. Anda juga dapat menggunakan ContentControl untuk mencegah pengguna mengedit bagian tertentu dari dokumen atau templat.
Visual Studio memperluas objek ContentControl ke beberapa kontrol host yang berbeda. Sementara objek ContentControl menampilkan semua 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 multipesan, atau Anda dapat menggunakan DatePickerContentControl untuk membuat pemilih tanggal. Kontrol host ini berperilaku mirip dengan ContentControl asli, tetapi juga memiliki kemampuan pengikatan peristiwa dan data tambahan.
Objek bookmark
Objek Bookmark mewakili area yang berdekatan dalam dokumen dengan posisi awal dan akhir. Anda dapat menggunakan bookmark untuk menandai lokasi dalam dokumen atau sebagai wadah untuk dokumen versi Cina. Objek Bookmark dapat berisi titik penyisipan atau sebesar seluruh dokumen. Bookmark memiliki karakteristik berikut yang membedakannya dari objek Rentang:
- Anda dapat memberi nama bookmark saat mendesain.
- Objek Bookmark disimpan bersama dokumen, sehingga tidak dihapus saat kode berhenti berjalan atau dokumen ditutup.
- Akses properti View dengan mengatur properti View ke false atau true.
- Visual Studio memperluas objek Bookmark dengan menyediakan kontrol host Bookmark. Kontrol host bookmark berperilaku mirip dengan Bookmark asli, tetapi juga memiliki kemampuan pengikatan peristiwa dan data tambahan. Anda dapat mengikat data ke kontrol bookmark pada dokumen dengan cara yang sama seperti Anda mengikat data ke kontrol kotak teks pada Formulir Windows.
Buat add-in Word VSTO
Setelah memahami konsep dasarnya, buka VS 2022 untuk membuat add-in Word VSTO baru, seperti yang ditunjukkan pada gambar di bawah ini:
Buat pita visual seperti yang ditunjukkan pada gambar berikut:
Klik dua kali Ribbon1.cs untuk membuka, hapus tab default, dan seret tab baru, seperti yang ditunjukkan di bawah ini:
Seret grup dan kontrol tombol ke tab tab baru, seperti yang ditunjukkan di bawah ini:
Klik dua kali tombol tombol yang baru dibuat untuk membuat peristiwa klik dengan kode berikut:
(Akhir)
|
Diposting pada 30/04/2023 20.53.15
|
|
|
|
Tuan tanah|
Diposting pada 30/04/2023 23.32.31
|
Diposting pada 02/05/2023 10.30.48