Bekerja dengan Bagian
Terkadang Anda menginginkan dokumen yang tidak memiliki pemformatan yang sama di semua halaman. Misalnya, Anda mungkin perlu mengubah format nomor halaman, memiliki ukuran dan orientasi halaman yang berbeda, atau memiliki halaman dokumen pertama sebagai halaman sampul tanpa penomoran apa pun. Anda dapat mencapainya dengan bagian.
Bagian adalah simpul level yang mengontrol header dan footer, orientasi, kolom, margin, pemformatan nomor halaman, dan lainnya.
Aspose.Words memungkinkan Anda mengelola bagian, membagi dokumen menjadi beberapa bagian, dan membuat perubahan pemformatan yang hanya berlaku untuk bagian tertentu. Aspose.Words menyimpan informasi tentang pemformatan bagian seperti header dan footer, pengaturan halaman, dan pengaturan kolom di pemisah bagian.
Artikel ini menjelaskan cara bekerja dengan bagian dan jeda bagian.
Apa Bagian dan Pemisah Bagian Itu
Bagian dokumen diwakili oleh kelas Section dan SectionCollection. Objek bagian adalah turunan langsung dari simpul Document dan dapat diakses melalui properti Sections. Anda dapat mengelola node tersebut dengan menggunakan beberapa metode seperti Remove, Add, IndexOf, dan lainnya.
Pemisah bagian adalah opsi yang membagi halaman dokumen menjadi beberapa bagian dengan tata letak yang dapat disesuaikan.
Jenis Jeda Bagian
Aspose.Words memungkinkan Anda untuk membagi dan memformat dokumen menggunakan pemisah bagian yang berbeda dari pencacahan BreakType:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
Anda juga dapat menggunakan pencacahan SectionStart untuk memilih jenis jeda yang hanya berlaku untuk bagian pertama seperti NewColumn, NewPage, EvenPage, dan OddPage.
Kelola Bagian
Karena suatu bagian adalah simpul komposit normal, seluruh manipulasi simpul API dapat digunakan untuk memanipulasi bagian: untuk menambah, menghapus, dan operasi lain pada bagian. Anda dapat membaca lebih lanjut tentang node di artikel Aspose.Words Model Objek Dokumen (DOM).
Di sisi lain, Anda juga dapat menggunakan DocumentBuilder API untuk bekerja dengan bagian. Pada artikel ini, kami akan fokus pada cara khusus bekerja dengan bagian-bagian ini.
Menyisipkan atau Menghapus Pemisah Bagian
Aspose.Words memungkinkan Anda menyisipkan pemisah bagian ke dalam teks menggunakan metode InsertBreak.
Contoh kode berikut menunjukkan cara menyisipkan pemisah bagian ke dalam dokumen:
Gunakan metode Remove untuk menghapus pemisah bagian. Jika Anda tidak perlu menghapus pemisah bagian tertentu dan sebagai gantinya menghapus konten bagian tersebut, Anda dapat menggunakan metode ClearContent.
Contoh kode berikut menunjukkan cara menghapus jeda bagian:
Memindahkan Bagian
Jika Anda ingin memindahkan bagian dari satu posisi ke posisi lain di dokumen Anda, Anda perlu mendapatkan indeks bagian tersebut. Aspose.Words memungkinkan Anda mendapatkan posisi bagian dari SectionCollection. Anda dapat menggunakan properti Sections untuk mendapatkan semua bagian dalam dokumen Anda. Tetapi jika Anda hanya ingin mendapatkan bagian pertama, Anda dapat menggunakan properti FirstSection.
Contoh kode berikut menunjukkan cara mengakses bagian pertama dan beralih melalui turunan dari simpul komposit:
Tentukan Tata Letak Bagian
Terkadang Anda ingin dokumen Anda terlihat lebih baik dengan membuat tata letak kreatif untuk bagian dokumen yang berbeda. Jika Anda ingin menentukan jenis kisi bagian saat ini, Anda dapat memilih mode tata letak bagian menggunakan pencacahan SectionLayoutMode:
- Standar
- Grid
- LineGrid
- SnapToChars
Contoh kode berikut menunjukkan cara membatasi jumlah baris yang mungkin dimiliki setiap halaman:
Sunting Bagian
Saat Anda menambahkan bagian baru ke dokumen Anda, tidak akan ada isi atau paragraf yang dapat Anda edit. Aspose.Words memungkinkan Anda untuk menjamin bahwa suatu bagian berisi isi dengan setidaknya satu paragraf menggunakan metode EnsureMinimum – ini akan secara otomatis menambahkan simpul Isi (atau HeaderFooter) ke dokumen dan kemudian menambahkan Paragraf ke dalamnya.
Contoh kode berikut menunjukkan cara menyiapkan simpul bagian baru menggunakan EnsureMinimum:
Tambahkan atau Tambahkan Konten
Jika Anda ingin menggambar beberapa bentuk atau menambahkan teks atau gambar di awal / akhir bagian, Anda dapat menggunakan metode AppendContent dan PrependContent dari kelas Section.
Contoh kode berikut menunjukkan cara menambahkan konten dari bagian yang ada:
Mengkloning Bagian
Aspose.Words memungkinkan Anda menduplikasi bagian dengan membuat salinan lengkapnya menggunakan metode Clone.
Contoh kode berikut menunjukkan cara mengkloning bagian pertama dalam dokumen Anda:
Salin Bagian antar Dokumen
Dalam beberapa kasus, Anda mungkin memiliki dokumen besar dengan banyak bagian dan Anda ingin menyalin konten bagian dari satu dokumen ke dokumen lainnya.
Aspose.Words memungkinkan Anda menyalin bagian antar dokumen menggunakan metode ImportNode.
Contoh kode berikut menunjukkan cara menyalin bagian di antara dokumen:
Bekerja dengan Header dan Footer Bagian
Aturan dasar untuk menampilkan header atau footer untuk setiap bagian cukup sederhana:
- Jika bagian tersebut tidak memiliki header/footer sendiri dari jenis tertentu, maka diambil dari bagian sebelumnya.
- Jenis header / footer yang ditampilkan pada halaman dikontrol oleh pengaturan bagian “Halaman Pertama Berbeda” dan “Halaman Ganjil & Genap Berbeda” – jika dinonaktifkan, judul bagian itu sendiri akan diabaikan.
Contoh kode berikut menunjukkan cara membuat bagian 2 dengan header berbeda:
Jika Anda ingin menghapus teks header dan footer tanpa menghapus objek HeaderFooter di dokumen Anda, Anda dapat menggunakan metode ClearHeadersFooters. Selain itu, Anda dapat menggunakan metode DeleteHeaderFooterShapes untuk menghapus semua bentuk dari header dan footer di dokumen Anda.
Contoh kode berikut menunjukkan cara menghapus konten semua header dan footer di suatu bagian:
Contoh kode berikut cara menghapus semua bentuk dari semua header footer di suatu bagian:
Sesuaikan Properti Halaman di Bagian
Sebelum mencetak halaman atau dokumen, Anda mungkin ingin menyesuaikan dan memodifikasi ukuran dan tata letak satu halaman atau seluruh dokumen. Dengan pengaturan halaman, Anda dapat mengubah pengaturan halaman dokumen seperti margin, orientasi, dan ukuran untuk mencetak halaman pertama atau halaman ganjil yang berbeda.
Aspose.Words memungkinkan Anda menyesuaikan properti halaman dan bagian menggunakan kelas PageSetup.
Contoh kode berikut menunjukkan cara mengatur properti seperti ukuran halaman dan orientasi untuk bagian saat ini:
Contoh kode berikut menunjukkan cara mengubah properti halaman di semua bagian: