Bekerja dengan Paragraf
Paragraf adalah sekumpulan karakter yang digabungkan menjadi blok logis dan diakhiri dengan karakter khusus – pemutusan paragraf. Di Aspose.Words, sebuah paragraf diwakili oleh kelas Paragraph.
Sisipkan Paragraf
Untuk menyisipkan paragraf baru ke dalam dokumen, sebenarnya Anda perlu memasukkan karakter pemisah paragraf ke dalamnya. DocumentBuilder.writeln juga menyisipkan string teks ke dalam dokumen, tetapi selain itu, ia menambahkan jeda paragraf.
Pemformatan font saat ini juga ditentukan oleh properti font dan pemformatan paragraf saat ini ditentukan oleh properti paragraph_format.
Contoh kode berikut menunjukkan cara menyisipkan paragraf ke dalam dokumen:
Format Paragraf
Pemformatan paragraf saat ini diwakili oleh objek ParagraphFormat yang dikembalikan oleh properti paragraph_format. Objek ini merangkum berbagai properti pemformatan paragraf yang tersedia dalam Microsoft Word. Anda dapat dengan mudah mengatur ulang pemformatan paragraf ke default ke gaya Normal, rata kiri, tanpa lekukan, tanpa spasi, tanpa batas, dan tanpa bayangan dengan memanggil clear_formatting.
Contoh kode berikut menunjukkan cara mengatur pemformatan paragraf:
Terapkan Gaya Paragraf
Beberapa objek pemformatan seperti gaya dukungan Font atau ParagraphFormat. Satu gaya bawaan atau yang ditentukan pengguna diwakili oleh objek Style yang berisi properti gaya terkait seperti nama, gaya dasar, format font dan paragraf gaya, dan sebagainya.
Selain itu, objek Style menyediakan properti Style.style_identifier yang mengembalikan pengidentifikasi gaya lokal-independen yang diwakili oleh nilai enumerasi StyleIdentifier. Intinya adalah nama gaya bawaan di Microsoft Word dilokalkan untuk bahasa berbeda. Dengan menggunakan pengidentifikasi gaya, Anda dapat menemukan gaya yang benar apa pun bahasa dokumennya. Nilai enumerasi sesuai dengan gaya bawaan Microsoft Word seperti Normal, Heading 1, Heading 2 dll. Semua gaya yang ditentukan pengguna diberi nilai StyleIdentifier.USER
Contoh kode berikut menunjukkan cara menerapkan gaya paragraf:
Sisipkan Pemisah Gaya untuk Menempatkan Gaya Paragraf Berbeda
Pemisah gaya dapat ditambahkan ke akhir paragraf menggunakan Ctrl + Alt + Masukkan Pintasan Keyboard ke MS Word. Fitur ini memungkinkan dua gaya paragraf berbeda digunakan dalam satu paragraf cetak logis. Jika Anda ingin beberapa teks dari awal judul tertentu muncul di Daftar Isi tetapi tidak ingin seluruh judul ada di Daftar Isi, Anda dapat menggunakan fitur ini
Contoh kode berikut menunjukkan cara menyisipkan pemisah gaya untuk mengakomodasi gaya paragraf yang berbeda:
Identifikasi Pemisah Gaya Paragraf
Aspose.Words menyediakan properti publik break_is_style_separator ke dalam kelas Paragraph yang memungkinkan mengidentifikasi Paragraf Pemisah Gaya seperti yang ditunjukkan pada contoh di bawah ini:
Menerapkan Batas dan Bayangan pada Paragraf
Perbatasan diwakili oleh BorderCollection. Ini adalah kumpulan objek Border yang diakses berdasarkan indeks atau tipe batas. Tipe perbatasan diwakili oleh enumerasi BorderType. Beberapa nilai enumerasi berlaku untuk beberapa atau hanya satu elemen dokumen. Misalnya, BorderType.BOTTOM berlaku untuk sel paragraf atau tabel, sedangkan BorderType.DIAGONALDOWN menentukan batas diagonal di sel tabel saja.
Koleksi perbatasan dan masing-masing perbatasan terpisah memiliki atribut serupa seperti warna, gaya garis, lebar garis, jarak dari teks, dan bayangan opsional. Mereka diwakili oleh properti dengan nama yang sama. Anda dapat mencapai tipe perbatasan yang berbeda dengan menggabungkan nilai properti. Selain itu, objek BorderCollection dan Border memungkinkan Anda menyetel ulang nilai ini ke default dengan memanggil metode Border.clear_formatting.
Aspose.Words juga memiliki kelas Shading yang berisi atribut bayangan untuk elemen dokumen. Anda dapat mengatur tekstur bayangan yang diinginkan dan warna yang diterapkan pada latar belakang dan latar depan elemen.
Tekstur bayangan diatur dengan nilai enumerasi TextureIndex yang memungkinkan penerapan berbagai pola ke objek Shading. Misalnya, untuk mengatur warna latar belakang elemen dokumen, gunakan nilai TextureIndex.TEXTURE_SOLID dan atur warna bayangan latar depan sesuai kebutuhan. Contoh di bawah ini menunjukkan cara menerapkan batas dan bayangan pada paragraf.
Contoh kode berikut menunjukkan cara menerapkan batas dan bayangan pada paragraf: