Bagikan melalui


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 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

  1. Buka Kotak Alat dan klik tab Kontrol Word.

  2. Bookmark Seret kontrol ke dokumen.

    Kotak dialog Tambahkan Bookmark muncul.

  3. Pilih teks atau item lain yang ingin Anda sertakan dalam bookmark.

  4. 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

  1. 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.

  2. Pada tab Sisipkan dari Pita, dalam grup Tautan, klik tombol Marka Buku.

  3. 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:

Untuk menambahkan kontrol Bookmark ke dokumen secara terprogram

  1. 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:

Untuk menambahkan kontrol Bookmark pada rentang tertentu

  1. 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.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
        extendedDocument.Paragraphs[1].Range, "FirstParagraph");
    

Untuk menambahkan kontrol Bookmark yang didasarkan pada kontrol Bookmark asli

  1. 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");
    }