Menambahkan kontrol Bookmark ke dokumen Word
Dalam proyek tingkat dokumen, Anda dapat menambahkan Bookmark kontrol ke dokumen dalam proyek Anda pada waktu desain atau pada waktu proses. Di proyek Add-in VSTO, Anda dapat menambahkan Bookmark kontrol ke dokumen apa pun yang terbuka pada waktu proses.
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 menjelaskan tugas-tugas berikut:
Menambahkan kontrol Bookmark pada waktu proses dalam proyek tingkat dokumen
Menambahkan kontrol Bookmark pada waktu proses dalam proyek Add-in VSTO
Untuk informasi selengkapnya tentang Bookmark kontrol, lihat Kontrol bookmark.
Menambahkan kontrol Bookmark pada Waktu Desain
Ada beberapa cara untuk menambahkan Bookmark kontrol ke dokumen dalam proyek tingkat dokumen pada waktu desain:
Dari Kotak Alat Visual Studio.
Anda dapat menyeret Bookmark kontrol dari Kotak Alat ke dokumen Anda. Anda mungkin ingin memilih cara ini jika Anda sudah menggunakan Kotak Alat untuk menambahkan kontrol Formulir Windows ke dokumen Anda.
Dari dalam Word.
Anda dapat menambahkan kontrol ke Bookmark dokumen Anda dengan cara yang sama seperti Anda akan menambahkan bookmark asli. Keuntungan menambahkannya dengan cara ini adalah Anda dapat memberi nama kontrol Anda pada saat Anda membuatnya.
Dari jendela Sumber Data.
Anda dapat menyeret kontrol ke Bookmark dokumen Anda dari jendela Sumber Data. Ini berguna ketika Anda ingin mengikat kontrol ke data secara bersamaan. Anda dapat menambahkan kontrol host dengan cara yang sama seperti Anda akan menambahkan kontrol Formulir Windows dari jendela Sumber Data. Untuk informasi selengkapnya, lihat Pengikatan dan Formulir Windows data.
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.
Untuk menambahkan kontrol Bookmark ke dokumen dari Kotak Alat
Buka Kotak Alat dan klik tab Kontrol Word.
Bookmark Seret kontrol ke dokumen.
Kotak dialog Tambahkan Bookmark muncul.
Pilih teks atau item lain yang ingin Anda sertakan dalam bookmark.
Klik OK.
Jika Anda tidak ingin menyimpan nama marka buku default, Anda bisa mengubah nama di jendela Properti .
Untuk menambahkan kontrol Bookmark ke dokumen di Word
Dalam dokumen yang dihosting di perancang Visual Studio, letakkan kursor tempat Anda ingin menambahkan marka buku, atau pilih teks yang Anda inginkan untuk diapit bookmark.
Pada tab Sisipkan dari Pita, dalam grup Tautan, klik tombol Marka Buku.
Dalam kotak dialog Bookmark , ketik nama marka buku baru, dan klik Tambahkan.
Menambahkan kontrol Bookmark pada waktu proses dalam proyek tingkat dokumen
Anda dapat menambahkan Bookmark kontrol secara terprogram ke dokumen Anda pada waktu proses dengan menggunakan metode Controls properti ThisDocument
kelas di proyek Anda. Ada dua metode kelebihan beban yang dapat Anda gunakan untuk menambahkan Bookmark kontrol dengan cara berikut:
Bookmark Tambahkan pada rentang tertentu.
Bookmark Tambahkan yang didasarkan pada bookmark asli dalam dokumen (yaitu, Bookmark).
Kontrol yang dibuat Bookmark secara dinamis tidak disimpan dalam dokumen saat dokumen ditutup. Namun, native Bookmark tetap berada dalam dokumen. Anda dapat membuat Bookmark ulang yang didasarkan pada bookmark asli saat berikutnya dokumen dibuka. Untuk informasi selengkapnya, lihat Menambahkan kontrol ke dokumen Office pada waktu proses.
Untuk menambahkan kontrol Bookmark ke dokumen secara terprogram
Di penanganan
ThisDocument_Startup
aktivitas di proyek Anda, sisipkan kode berikut untuk menambahkan Bookmark kontrol ke paragraf pertama dalam dokumen.Microsoft.Office.Tools.Word.Bookmark firstParagraph; firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range, "FirstParagraph");
Catatan
Jika Anda ingin membuat Bookmark kontrol dari yang sudah ada Bookmark, gunakan AddBookmark metode dan teruskan Bookmarkdi .
Menambahkan kontrol Bookmark pada waktu proses dalam proyek Add-in VSTO
Anda dapat menambahkan Bookmark kontrol secara terprogram ke dokumen terbuka apa pun pada waktu proses dengan menggunakan Add-in VSTO. Untuk melakukan ini, buat Document item host yang didasarkan pada dokumen terbuka, lalu gunakan metode Controls properti item host ini. Ada dua metode kelebihan beban yang dapat Anda gunakan untuk menambahkan Bookmark kontrol dengan cara berikut:
Bookmark Tambahkan pada rentang tertentu.
Bookmark Tambahkan yang didasarkan pada bookmark asli dalam dokumen (yaitu, Bookmark).
Kontrol yang dibuat Bookmark secara dinamis tidak disimpan dalam dokumen saat dokumen ditutup. Namun, native Bookmark tetap berada dalam dokumen. Anda dapat membuat Bookmark ulang yang didasarkan pada bookmark asli saat berikutnya dokumen dibuka. Untuk informasi selengkapnya, lihat Mempertahankan kontrol dinamis di dokumen Office.
Untuk informasi selengkapnya tentang membuat item host di proyek Add-in VSTO, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.
Untuk menambahkan kontrol Bookmark pada rentang tertentu
AddBookmark Gunakan metode , dan teruskan Range di mana Anda ingin menambahkan Bookmark.
Contoh kode berikut menambahkan baru Bookmark ke awal dokumen aktif. Untuk menggunakan contoh ini, jalankan kode dari
ThisAddIn_Startup
penanganan aktivitas dalam proyek Add-in Word VSTO.
Untuk menambahkan kontrol Bookmark yang didasarkan pada kontrol Bookmark asli
AddBookmark Gunakan metode , dan teruskan yang ada Bookmark yang ingin Anda gunakan sebagai dasar untuk yang baru Bookmark.
Contoh kode berikut membuat baru Bookmark yang didasarkan pada yang pertama Bookmark dalam dokumen aktif. Untuk menggunakan contoh ini, jalankan kode dari
ThisAddIn_Startup
penanganan aktivitas dalam proyek Add-in Word VSTO.if (this.Application.ActiveDocument.Bookmarks.Count > 0) { object index = 1; Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index); Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument); Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark( firstBookmark, "VSTOBookmark"); }