Bagikan melalui

Kontrol marka buku

  • Artikel

Kontrol Bookmark adalah marka buku yang memiliki nama unik, mengekspos peristiwa, dan dapat terikat ke data. Marka buku dapat digunakan sebagai tempat penampung untuk menandai item atau lokasi dalam dokumen Microsoft Office Word. Kontrol Bookmark adalah kombinasi objek Bookmark dan Range objek.

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, Anda dapat menambahkan Bookmark kontrol ke dokumen 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. Untuk informasi selengkapnya, lihat Cara: Menambahkan kontrol Bookmark ke dokumen Word.

Mengikat data ke kontrol

Bookmark Kontrol mendukung pengikatan data sederhana. Marka buku harus terikat ke sumber data menggunakan DataBindings properti . Properti pengikatan data default dari marka buku adalah Text properti .

Jika data dalam himpunan data terikat diperbarui, Bookmark kontrol akan menampilkan perubahan.

Dalam proyek tingkat dokumen, Anda juga dapat mengikat data ke marka buku dengan menggunakan jendela Sumber Data. Untuk informasi selengkapnya, lihat Cara: Mengisi dokumen dengan data dari objek.

Pemformatan

Pemformatan yang dapat diterapkan ke Bookmark bisa diterapkan ke Bookmark kontrol. Pemformatan ini mencakup font, inden, penspasian, penomoran, dan gaya.

Menetapkan teks ke marka buku

Perbedaan tambahan antara Microsoft.Office.Interop.Word.Bookmark objek dan Microsoft.Office.Tools.Word.Bookmark kontrol adalah bagaimana perilakunya saat teks ditetapkan ke marka buku. Jika Anda menetapkan teks ke panjang Microsoft.Office.Interop.Word.Bookmarknol , teks ditambahkan ke sebelah kanan marka buku dan marka buku tetap panjang nol. Namun, jika Anda menetapkan teks ke panjang Microsoft.Office.Tools.Word.Bookmarknol , teks disisipkan ke dalam marka buku dan panjang marka buku meluas ke jumlah total karakter yang disisipkan.

Kontrol Microsoft.Office.Tools.Word.Bookmark juga memiliki Bookmark.Text properti . Properti ini berbeda dari Range.Text properti yang tersedia pada Bookmark.Range properti Microsoft.Office.Tools.Word.Bookmark kontrol, atau Bookmark.Range properti Microsoft.Office.Interop.Word.Bookmark objek.

Properti Teks Deskripsi
Bookmark.Text Gunakan properti ini untuk menampilkan teks di dalam marka buku dan biarkan marka buku pada dokumen. Menetapkan teks ke marka buku memperluas rentang marka buku dan tidak menghapus marka buku.

Misalnya, Bookmark1.Text = "Hello world" menyisipkan teks ke marka buku dan membiarkan bookmark tetap utuh.
Range.Text Gunakan properti ini untuk menampilkan teks di lokasi marka buku dan secara otomatis menghapus marka buku. Misalnya, Bookmark1.Range.Text = "Hello world" menyisipkan teks ke dalam marka buku dan menghapus marka buku.

Mengganti nama kontrol pada waktu desain

Dalam proyek tingkat dokumen, saat Anda menyeret Bookmark kontrol dari Kotak Alat ke dokumen Anda, Visual Studio secara otomatis menghasilkan nama untuk kontrol tersebut. Anda dapat mengubah nama kontrol di jendela Properti .

Kontrol yang tumpang tindih

Kontrol marka buku dapat saling tumpang tindih. Teks yang sama dapat dibagikan oleh lebih dari satu marka buku. Saat Anda menetapkan teks baru ke salah satu marka buku yang tumpang tindih, teks tersebut hanya berisi teks baru dan marka buku tidak lagi tumpang tindih. Marka buku lainnya sekarang hanya berisi teks yang tidak dibagikan antara marka buku asli yang tumpang tindih.

Tabel berikut ini memperlihatkan bagaimana kalimat "Ini adalah teks sampel." dibagikan oleh dua marka buku yang tumpang tindih:

Bookmark Teks
Bookmark yang tumpang tindih [ini adalah {sample] text.}
Bookmark1 Ini adalah sampel
Marka buku2 teks sampel.

Jika Anda menetapkan teks baru "Ini adalah penggantian." ke Bookmark1, marka buku tidak tumpang tindih, dan Bookmark2 hanya menyimpan teks yang awalnya bukan bagian dari Bookmark1.

Bookmark Teks
Dua marka buku terpisah [ini adalah pengganti] { text.}
Bookmark1 Ini adalah penggantian
Marka buku2 Teks.

Jika Anda mengubah teks marka buku yang berisi bookmark lain, marka buku dalam tidak akan dihapus. Namun, bookmark dalam menjadi bookmark kosong, dan berpindah ke akhir bookmark luar.

Tabel berikut ini memperlihatkan bagaimana kalimat "Ini adalah teks sampel." dibagikan oleh marka buku yang terkandung dalam marka buku lain:

Bookmark Teks
Bookmark yang tumpang tindih [ini adalah {sample} teks.]
Bookmark1 Ini adalah teks sampel.
Marka buku2 sampel

Jika Anda menetapkan teks baru "Ini adalah penggantian." ke Bookmark1, marka buku tidak lagi tumpang tindih dan Bookmark2 menjadi marka buku kosong yang terletak di akhir Bookmark1.

Bookmark Teks
Dua marka buku terpisah [ini adalah pengganti.]{}
Bookmark1 Ini adalah pengganti.
Marka buku2 <kosong>

Aktivitas

Peristiwa berikut tersedia untuk Bookmark kontrol:

Konten terkait