Bekerja dengan Tabel Konten
Seringkali Anda akan bekerja dengan dokumen yang mengandung tabel konten (TOC). Sitemap Aspose.Words Anda dapat memasukkan tabel konten Anda sendiri atau sepenuhnya membangun kembali tabel konten yang ada dalam dokumen hanya menggunakan beberapa baris kode.
Artikel ini menguraikan cara bekerja dengan tabel bidang konten dan menunjukkan:
- Bagaimana cara memasukkan TOC baru.
- Memperbarui TOC baru atau yang ada dalam dokumen.
- Tentukan beralih untuk mengontrol pemformatan dan struktur keseluruhan TOC.
- Bagaimana cara memodifikasi gaya dan penampilan tabel konten.
- Bagaimana cara menghapus seluruh
TOClapangan bersama dengan semua entri dari dokumen.
Masukkan Tabel Konten Secara Program
Anda dapat memasukkan TOC (table of contents) ke dalam dokumen pada posisi saat ini dengan memanggil InsertTableOfContents Login
Meja konten dalam dokumen Word dapat dibangun dalam beberapa cara dan diformat menggunakan berbagai pilihan. Bidang beralih bahwa Anda melewati metode mengontrol cara tabel dibangun dan ditampilkan dalam dokumen Anda.
Switch default yang digunakan dalam TOC login Microsoft Word Sitemap **""\o “1-3 \h \z \u”**Sitemap Deskripsi switch ini serta daftar switch yang didukung dapat ditemukan nanti dalam artikel. Anda dapat menggunakan panduan untuk mendapatkan sakelar yang benar atau jika Anda sudah memiliki dokumen yang mengandung serupa TOC Anda ingin Anda dapat menunjukkan kode lapangan (*ALT + F9 *) dan menyalin sakelar langsung dari lapangan.
Contoh kode berikut menunjukkan cara memasukkan tabel kolom Konten ke dalam dokumen:
Contoh kode berikut menunjukkan cara memasukkan tabel konten (TOC) ke dalam dokumen menggunakan gaya judul sebagai entri:
Kode menunjukkan tabel konten baru dimasukkan ke dalam dokumen kosong. Login DocumentBuilder kelas kemudian digunakan untuk memasukkan beberapa format konten sampel dengan gaya judul yang sesuai yang digunakan untuk menandai konten yang disertakan dalam TOC. Garis berikutnya kemudian mengisi TOC dengan memperbarui bidang dan tata letak halaman dokumen.
TOC lapangan, tetapi tanpa konten yang terlihat. Ini karena TOC lapangan telah dimasukkan tetapi belum diisi sampai diperbarui dalam dokumen. Informasi lebih lanjut tentang ini dibahas di bagian berikutnya.
Memperbarui Tabel Konten
Aspose.Words memungkinkan Anda untuk sepenuhnya memperbarui TOC hanya dengan beberapa baris kode. Ini dapat dilakukan untuk mengisi sisipan baru TOC atau untuk memperbarui yang ada TOC setelah perubahan dokumen telah dibuat.
Dua metode berikut harus digunakan untuk memperbarui TOC kolom dalam dokumen:
Harap dicatat bahwa dua metode pembaruan ini diperlukan untuk disebut dalam urutan itu. Jika membalikkan tabel konten akan diisi tetapi tidak ada nomor halaman akan ditampilkan. Jumlah TOC yang berbeda dapat diperbarui. Metode ini akan secara otomatis memperbarui semua TOC yang ditemukan dalam dokumen.
Contoh kode berikut menunjukkan cara membangun kembali sepenuhnya TOC bidang dalam dokumen dengan memprovokasi pembaruan lapangan:
Panggilan pertama Document.updateFields() akan membangun TOCSitemap semua entri teks diisi dan Meme it TOC muncul hampir lengkap. Satu-satunya hal yang hilang adalah nomor halaman yang sekarang ditampilkan dengan “?”.
Panggilan kedua Document.updatePageLayout() akan membangun tata letak dokumen dalam memori. Perlu dilakukan untuk mengumpulkan nomor halaman entri. Jumlah halaman yang benar dihitung dari panggilan ini kemudian dimasukkan ke dalam TOC.
Gunakan Switch untuk Mengontrol Tabel Konten Perilaku
Seperti di bidang lain, Meme it TOC bidang dapat menerima switch didefinisikan dalam kode lapangan yang mengontrol bagaimana tabel konten dibangun. Sakelar tertentu digunakan untuk mengontrol entri yang disertakan dan pada tingkat apa sementara yang lain digunakan untuk mengontrol tampilan TOC. Saklar dapat digabungkan bersama untuk memungkinkan tabel konten yang kompleks untuk diproduksi.
Secara default, switch ini di atas disertakan ketika memasukkan default TOC dalam dokumen. Login TOC tanpa switch akan menyertakan konten dari gaya judul bawaan (seperti jika sakelar \O ditetapkan).
Sitemap TOC beralih yang didukung oleh Aspose.Words tercantum di bawah ini dan penggunaannya dijelaskan secara rinci. Mereka dapat dibagi menjadi bagian terpisah berdasarkan jenis mereka. Sakelar di bagian pertama menentukan konten apa yang disertakan dalam TOC dan sakelar di bagian kedua mengontrol penampilan TOC.
Jika switch tidak terdaftar di sini maka saat ini tidak didukung. Semua switch akan didukung dalam versi masa depan. Kami menambahkan dukungan lebih lanjut untuk setiap rilis.
Login
| Login | Sitemap |
|---|---|
| Heading Styles (\O Switch) |
Switch ini mendefinisikan bahwa |
Setiap konten yang diformat dengan gaya ini disertakan dalam tabel konten. Tingkat judul akan menentukan tingkat hirarkis yang sesuai dari entri di TOC. Misalnya, paragraf dengan judul 1 gaya akan diperlakukan sebagai tingkat pertama di `TOC` sedangkan paragraf dengan Heading 2 akan diperlakukan sebagai tingkat berikutnya dalam hirarki dan sebagainya.
*(\U switch)*
|
Setiap paragraf dapat mendefinisikan tingkat garis besar di bawah opsi Paragraf.
Pengaturan ini menentukan tingkat paragraf ini harus diobati dalam hierarki dokumen. Ini adalah praktik yang umum digunakan untuk dengan mudah mengatur tata letak dokumen. hierarki ini dapat dilihat dengan mengubah ke Outline View di Microsoft WordSitemap Mirip dengan gaya judul, bisa ada 1 – 9 tingkat garis samping tingkat "Body Text". Tingkat garis besar 1 – 9 akan muncul di `TOC` di tingkat hierarki yang sesuai
Setiap konten dengan tingkat garis besar baik diatur dalam gaya paragraf atau langsung pada paragraf itu sendiri termasuk dalam TOC. Sitemap Aspose.Words tingkat garis besar diwakili oleh Meme it `ParagraphFormat.OutlineLevel` properti dari node Paragraf. Tingkat garis besar gaya paragraf diwakili dengan cara yang sama dengan `Style.ParagraphFormat` Login
Perhatikan bahwa gaya judul bawaan seperti Heading 1 memiliki set wajib tingkat garis besar dalam pengaturan gaya.
*(\T switch)*
|
Switch ini akan memungkinkan gaya kustom untuk digunakan ketika mengumpulkan entri untuk digunakan di TOC. Ini sering digunakan bersama dengan sakelar \ O untuk menyertakan gaya kustom bersama dengan gaya kepala built-in di TOC.
Parameter switch harus ditutup dalam tanda pidato. Banyak gaya kustom dapat disertakan, untuk setiap gaya, nama harus ditentukan diikuti oleh komma diikuti oleh tingkat bahwa gaya harus muncul di `TOC` Sitemap Gaya lebih lanjut juga dipisahkan oleh komma juga.
Sitemap
{ TOC \o "1-3" \t "CustomHeading1, 1, CustomHeading2, 2"}
akan menggunakan konten dengan CustomHeading1 sebagai konten level 1 di `TOC` dan CustomHeading2 sebagai level 2.
| | Gunakan Bidang TC* (\F dan \ L Switches) *
|
Dalam versi lama Microsoft Word, satu-satunya cara untuk membangun `TOC` adalah penggunaan bidang TC. Bidang ini dimasukkan tersembunyi ke dalam dokumen bahkan ketika kode lapangan ditampilkan. Mereka termasuk teks yang harus ditampilkan di entri dan `TOC` dibangun dari mereka. Fungsi ini sekarang tidak digunakan sangat sering tetapi mungkin masih berguna dalam beberapa kesempatan untuk memasukkan entri di `TOC` yang tidak teridentifikasi terlihat dalam dokumen.
Ketika memasukkan bidang ini muncul tersembunyi bahkan ketika kode lapangan ditampilkan. Mereka tidak dapat dilihat tanpa menunjukkan konten tersembunyi. Untuk melihat bidang ini Tampilkan format paragraf harus dipilih.
Bidang ini dapat dimasukkan ke dalam dokumen pada setiap posisi seperti bidang lain dan diwakili oleh `FieldType.FieldTOCEntry` Sitemap
Sakelar \F dalam `TOC` digunakan untuk menentukan bahwa bidang TC harus digunakan sebagai entri. Sakelar sendiri tanpa pengidentifikasi tambahan berarti bahwa setiap bidang TC dalam dokumen akan disertakan. Setiap parameter tambahan, sering satu huruf, akan menunjuk satu-satunya bidang TC yang memiliki switch \f yang cocok akan dimasukkan dalam TOC. Sitemap
{ TOC \f t }
hanya akan mencakup bidang TC seperti Meme it
{ TC \f t }
Login `TOC` lapangan juga memiliki sakelar terkait, sakelar "\L" menentukan bahwa hanya lapangan TC dengan tingkat dalam kisaran yang ditentukan disertakan.
Login `TC` ladang sendiri juga bisa `{several, multiple, a few, many, numerous}` beralih set. Sitemap
- \F - Dijelaskan di atas. Sitemap
- \L - Mendefinisikan tingkat di `TOC` Bidang TC ini akan muncul. Meme it Login `TOC` yang menggunakan switch yang sama ini hanya akan mencakup bidang TC ini jika berada dalam kisaran yang ditentukan.
Login Login `TOC` entri tidak ditampilkan. Kode sampel cara memasukkan kolom TC dapat ditemukan di bagian berikutnya.
|Penampilan Saklar Terkait
| Login | Sitemap |
|---|---|
| Omit Page Numbers (\N Switch) |
Switch ini digunakan untuk menyembunyikan nomor halaman untuk tingkat tertentu TOC. Misalnya, Anda dapat mendefinisikan |
{TOC \o "1-4" \n "3-4" }
dan nomor halaman pada entri tingkat 3 dan empat akan disembunyikan bersama dengan titik-titik pemimpin (jika ada). Untuk menentukan satu tingkat kisaran harus tetap digunakan, misalnya, "1-1" akan mengecualikan nomor halaman hanya untuk tingkat pertama.
Menyediakan rentang level tidak akan memomit nomor halaman untuk semua tingkat di TOC. Ini berguna untuk mengatur ketika mengekspor dokumen ke HTML atau format serupa. Ini karena format berbasis HTML tidak memiliki konsep halaman dan dengan demikian tidak perlu nomor halaman.
| | Masukkan Sebagai Hyperlinks*(\H Switch)* |
Switch ini menentukan bahwa `TOC` entri dimasukkan sebagai hyperlink. Ketika melihat dokumen dalam Microsoft Word entri ini masih akan muncul sebagai teks normal di dalam `TOC` tetapi di hyperlink dan dengan demikian dapat digunakan untuk menavigasi ke posisi entri asli dalam dokumen dengan menggunakan * Ctrl + Klik Kiri * Microsoft WordSitemap Ketika switch ini disertakan kemudian tautan ini juga dipertahankan dalam format lain. Contohnya, dalam format berbasis HTML termasuk format EPUB dan rendered seperti PDF dan XPS, ini akan diekspor sebagai link kerja.
Tanpa set switch ini, `TOC` dalam semua output ini akan diekspor sebagai teks biasa dan tidak akan menunjukkan perilaku ini. Jika dokumen dibuka di MS Word teks entri juga tidak dapat diklik dengan cara ini tetapi nomor halaman masih dapat digunakan untuk menavigasi entri asli.
| | **Set Separator Character***(\P Switch)*
|
Switch ini memungkinkan konten memisahkan judul entri dan nomor halaman untuk mudah diubah di TOC. Pemisah untuk digunakan harus ditentukan setelah sakelar ini dan tertutup dalam tanda bicara.
Terjemahkan ke apa yang didokumentasikan dalam dokumentasi Office, hanya satu karakter yang dapat digunakan daripada hingga lima. Ini berlaku untuk Word MS dan Aspose.WordsSitemap
Menggunakan switch ini tidak dianjurkan karena tidak memungkinkan banyak kontrol atas apa yang digunakan untuk memisahkan entri dan nomor halaman di TOC. Sebaliknya, disarankan untuk mengedit yang tepat `TOC` gaya seperti `StyleIdentifier.TOC1` dan dari sana mengedit gaya pemimpin dengan akses ke anggota font tertentu dll. Rincian lebih lanjut tentang cara melakukan ini dapat ditemukan nanti dalam artikel.
| | **Preserve Tab Entries***(\W Switch)* |
Menggunakan switch ini akan menentukan bahwa setiap entri yang memiliki karakter tab, misalnya, judul yang memiliki tab di akhir garis, akan dipertahankan sebagai karakter tab yang tepat ketika mengisi TOC. Ini berarti fungsi karakter tab akan hadir dalam `TOC` dan dapat digunakan untuk memformat entri. Misalnya, entri tertentu dapat menggunakan stop tab dan karakter tab untuk meratakan teks. Selama `TOC` tingkat mendefinisikan tab yang setara berhenti kemudian dihasilkan `TOC` entri akan muncul dengan jarak yang sama.
Dalam situasi yang sama jika sakelar ini tidak didefinisikan maka karakter tab akan dikonversi ke ruang putih yang setara dengan tab yang tidak berfungsi. Output akan muncul seperti yang diharapkan.
| | **Preserve New Line Entries***(\X Switch)*
|
Mirip dengan sakelar di atas, sakelar ini menentukan bahwa judul membentang lebih dari beberapa garis (menggunakan karakter garis baru, bukan paragraf terpisah) akan dipertahankan karena mereka berada di TOC yang dihasilkan. Misalnya, judul yang menyebar di beberapa garis dapat menggunakan karakter garis baru (Ctrl + Enter atau `ControlChar.LineBreak`) untuk memisahkan konten di berbagai garis. Dengan saklar ini ditentukan, entri di `TOC` akan menjaga karakter garis baru ini seperti yang ditunjukkan di bawah ini.
Dalam situasi ini, jika sakelar tidak didefinisikan maka karakter garis baru dikonversi ke ruang putih tunggal.
|Masukkan Bidang TC
Anda dapat memasukkan bidang TC baru pada posisi saat ini DocumentBuilder dengan memanggil DocumentBuilder.InsertField metode dan menentukan nama lapangan sebagai “TC” bersama dengan sakelar yang diperlukan.
Contoh kode berikut menunjukkan cara memasukkan TC ke dalam dokumen menggunakan DocumentBuilderSitemap
Sering garis teks tertentu ditunjuk untuk Meme it TOC dan ditandai dengan TC Login Cara mudah untuk melakukan ini di MS Word adalah untuk menyoroti teks dan tekan * ALT + SHIFT + O *. Ini secara otomatis menciptakan TC kolom menggunakan teks yang dipilih. Teknik yang sama dapat dicapai melalui kode. Kode di bawah ini akan menemukan teks yang cocok input dan masukkan TC bidang dalam posisi yang sama dengan teks. Kode didasarkan pada teknik yang sama digunakan dalam artikel. Contoh kode berikut menunjukkan cara menemukan dan memasukkan TC kolom pada teks dalam dokumen.
Modifikasi Tabel Konten
Mengubah Format Gaya
Pemformatan entri di TOC tidak menggunakan gaya asli dari entri yang ditandai, bukan, setiap tingkat diformat menggunakan setara TOC Login Misalnya, tingkat pertama di Meme it TOC diformat dengan Login gaya, tingkat kedua diformat dengan Login gaya dan sebagainya. Ini berarti bahwa untuk mengubah tampilan TOC gaya ini harus dimodifikasi. Sitemap Aspose.Words gaya ini diwakili oleh lokale-independent StyleIdentifier.TOC1 Sitemap StyleIdentifier.TOC9 dan dapat diambil dari Meme it Document.Styles koleksi menggunakan pengidentifikasi ini.
Setelah gaya dokumen yang sesuai telah mengambil format untuk gaya ini dapat dimodifikasi. Setiap perubahan pada gaya ini akan secara otomatis tercermin dalam TOC dalam dokumen.
Contoh kode berikut mengubah properti format yang digunakan pada tingkat pertama TOC Login
Hal ini juga berguna untuk dicatat bahwa setiap format langsung paragraf (dibuktikan pada paragraf itu sendiri dan tidak dalam gaya) ditandai untuk dimasukkan dalam TOC akan disalin di entri di TOC. Misalnya, jika gaya Heading 1 digunakan untuk menandai konten untuk TOC dan gaya ini memiliki format Bold sementara paragraf juga memiliki format italic langsung diterapkan untuk itu. Sitemap TOC entri tidak akan berani karena itu adalah bagian dari format gaya namun itu akan menjadi italic karena ini diformat langsung pada paragraf.
Anda juga dapat mengontrol format pemisah yang digunakan antara setiap entri dan nomor halaman. Secara default, ini adalah garis bertitik yang tersebar di halaman yang menghitung menggunakan karakter tab dan tab kanan berhenti berbaring dekat dengan margin yang tepat.
Menggunakan Style kelas diambil untuk tertentu TOC tingkat yang ingin Anda modifikasi, Anda juga dapat memodifikasi bagaimana ini muncul dalam dokumen.
Untuk mengubah bagaimana ini muncul pertama Style.ParagraphFormat harus disebut untuk mengambil format paragraf untuk gaya. Dari ini, tab berhenti dapat diambil dengan memanggil ParagraphFormat.TabStops dan tab yang tepat berhenti dimodifikasi. Menggunakan teknik yang sama ini tab itu sendiri dapat dipindahkan atau dihapus sama sekali.
Contoh kode berikut menunjukkan cara memodifikasi posisi tab kanan berhenti di TOC paragraf terkait.
Hapus Tabel Konten dari Dokumen
Tabel konten dapat dihapus dari dokumen dengan menghapus semua node yang ditemukan di antara FieldStart dan node FieldEnd dari TOC Login
Kode di bawah ini menunjukkan ini. Penghapusan TOC lapangan lebih sederhana dari lapangan normal karena kita tidak melacak ladang bersarang. Sebaliknya, kami memeriksa Meme it FieldEnd node adalah tipe FieldType.FieldTOC yang berarti kita telah menemukan ujung TOC saat ini. Teknik ini dapat digunakan dalam kasus ini tanpa khawatir tentang bidang bersarang apa pun karena kita dapat menganggap bahwa setiap dokumen yang terbentuk dengan benar tidak akan memiliki sepenuhnya bersarang TOC di dalam bidang lain TOC Login
Pertama FieldStart Sitemap TOC dikumpulkan dan disimpan. Sitemap TOC kemudian disebutkan sehingga semua node di dalam bidang dikunjungi dan disimpan. node kemudian dihapus dari dokumen. Contoh kode berikut menunjukkan bagaimana menghapus yang ditentukan TOC dari dokumen.
Tabel Ekstrak Konten
Jika Anda ingin mengekstrak tabel konten dari dokumen Word, sampel kode berikut dapat digunakan.