Bagikan melalui


Memperbarui teks marka buku secara terprogram

Anda bisa menyisipkan teks ke dalam marka buku tempat penampung dalam dokumen Microsoft Office Word sehingga Anda bisa mengambil teks di lain waktu, atau mengganti teks dalam marka buku. Jika Anda mengembangkan kustomisasi tingkat dokumen, Anda juga dapat memperbarui teks dalam Bookmark kontrol yang terikat ke data. Untuk informasi selengkapnya, lihat Mengikat data ke kontrol di solusi Office.

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.

Objek bookmark bisa menjadi salah satu dari dua jenis:

  • Bookmark Kontrol host.

    Bookmark kontrol memperluas objek asli Bookmark dengan mengaktifkan pengikatan data dan mengekspos peristiwa. Untuk informasi selengkapnya tentang kontrol host, lihat Gambaran umum item host dan kontrol host.

  • Objek asli Bookmark .

    Bookmark objek tidak memiliki kemampuan peristiwa atau pengikatan data.

    Saat Anda menetapkan teks ke marka buku, perilaku berbeda antara dan BookmarkBookmark. Untuk informasi selengkapnya, lihat Kontrol bookmark.

Menggunakan kontrol host

Untuk memperbarui konten marka buku menggunakan kontrol Bookmark

  1. Buat prosedur yang mengambil bookmark argumen untuk nama marka buku, dan newText argumen untuk string yang akan ditetapkan ke Text properti .

    Catatan

    Menetapkan teks ke Text properti Bookmark atau FormattedText kontrol tidak menyebabkan bookmark dihapus.

    static void BookMarkReplace(
        ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
        string newText)
    {
    
  2. Tetapkan string newText ke Text properti .Bookmark

        bookmark.Text = newText;
    }
    

Menggunakan objek Word

Untuk memperbarui konten marka buku menggunakan objek Bookmark Word

  1. Buat prosedur yang memiliki bookmark argumen untuk nama Bookmark, dan newText argumen untuk string yang akan ditetapkan ke Text properti marka buku.

    Catatan

    Menetapkan teks ke objek Word Bookmark asli menyebabkan marka buku dihapus.

    internal void BookMarkReplaceNative(
        Word.Bookmark bookmark, 
        string newText)
    {
    
  2. Tetapkan string newText ke Text properti marka buku, yang secara otomatis menghapus bookmark. Kemudian tambahkan kembali bookmark ke Bookmarks koleksi.

    Contoh kode berikut dapat digunakan dalam kustomisasi tingkat dokumen.

        object rng = bookmark.Range;
        string bookmarkName = bookmark.Name;
    
        bookmark.Range.Text = newText;
    
        this.Bookmarks.Add(bookmarkName, ref rng); 
    }
    

    Contoh kode berikut dapat digunakan dalam Add-in VSTO. Contoh ini menggunakan dokumen aktif.

        object rng = bookmark.Range;
        string bookmarkName = bookmark.Name;
    
        bookmark.Range.Text = newText;
    
        Word.Document document = this.Application.ActiveDocument;
        document.Bookmarks.Add(bookmarkName, ref rng);
    }