Menerapkan Pemformatan

Setiap elemen tabel dapat diterapkan dengan pemformatan yang berbeda. Misalnya, pemformatan tabel akan diterapkan ke seluruh tabel, pemformatan baris hanya ke baris tertentu, pemformatan sel hanya ke sel tertentu.

Aspose.Words menyediakan API yang kaya untuk mengambil dan menerapkan pemformatan ke tabel. Anda dapat menggunakan simpul Table, RowFormat, dan CellFormat untuk mengatur pemformatan.

Pada artikel ini, kita akan membahas tentang cara menerapkan pemformatan ke node tabel yang berbeda dan pengaturan pemformatan tabel apa yang didukung Aspose.Words.

Terapkan Pemformatan ke Node yang Berbeda

Di bagian ini, kita akan melihat penerapan pemformatan ke berbagai simpul tabel.

Pemformatan Tingkat Tabel

Untuk menerapkan pemformatan ke tabel, Anda dapat menggunakan properti yang tersedia pada simpul Table yang sesuai menggunakan kelas Table, PreferredWidth, dan TableCollection.

Perhatikan bahwa tabel harus memiliki setidaknya satu baris sebelum properti tabel dapat diterapkan. Artinya, saat membuat tabel dengan DocumentBuilder, pemformatan ini harus dilakukan setelah pemanggilan pertama ke InsertCell, atau setelah baris pertama ditambahkan ke tabel, atau saat node disisipkan langsung ke DOM.

Gambar-gambar di bawah ini menunjukkan representasi fitur pemformatan Table di Microsoft Word dan properti terkait di Aspose.Words.

Contoh kode berikut menunjukkan cara menerapkan batas garis luar ke tabel:

Contoh kode berikut menunjukkan cara membuat tabel dengan semua batas diaktifkan (kisi):

Pemformatan Tingkat Baris

Tingkat baris

Perhatikan bahwa Row hanya dapat berupa simpul turunan dari Table. Pada saat yang sama, harus ada setidaknya satu Cell di Row agar pemformatan dapat diterapkan padanya.

Gambar-gambar di bawah ini menunjukkan representasi fitur pemformatan Row di Microsoft Word dan properti terkait di Aspose.Words.

Contoh kode berikut menunjukkan cara mengubah pemformatan baris tabel:

Pemformatan Tingkat Sel

Pemformatan tingkat sel dikontrol oleh kelas Cell, CellFormat, dan CellCollection.

Perhatikan bahwa Cell hanya dapat berupa simpul turunan dari Row. Pada saat yang sama, harus ada setidaknya satu Paragraph di Cell agar pemformatan dapat diterapkan padanya.

Selain Paragraph, Anda juga dapat menyisipkan Table ke dalam Cell.

Gambar-gambar di bawah ini menunjukkan representasi fitur pemformatan Cell di Microsoft Word dan properti terkait di Aspose.Words.

Contoh kode berikut menunjukkan cara mengubah pemformatan sel tabel:

Contoh kode berikut menunjukkan cara mengatur jumlah ruang (dalam poin) untuk ditambahkan ke kiri/atas/kanan / bawah isi sel:

Tentukan Ketinggian Baris

Cara paling sederhana untuk mengatur tinggi baris adalah dengan menggunakan DocumentBuilder. Dengan menggunakan properti RowFormat yang sesuai, Anda dapat mengatur pengaturan ketinggian default atau menerapkan ketinggian yang berbeda untuk setiap baris dalam tabel.

Dalam Aspose.Words, tinggi baris tabel dikontrol oleh:

• properti tinggi baris – Height
• properti aturan tinggi untuk baris yang diberikan - HeightRule

Pada saat yang sama, ketinggian yang berbeda dapat diatur untuk setiap baris-ini memungkinkan Anda untuk mengontrol pengaturan tabel secara luas.

Opsi aturan untuk menentukan tinggi objek dapat diatur menggunakan pencacahan HeightRule.

Contoh kode berikut menunjukkan cara membuat tabel yang berisi satu sel dan menerapkan pemformatan baris:

Menentukan Lebar Tabel dan Sel

Tabel dalam dokumen Microsoft Word menyediakan beberapa cara berbeda untuk mengubah ukuran tabel dan sel individual. Properti ini memungkinkan kontrol yang cukup besar atas tampilan dan perilaku tabel, sehingga Aspose.Words mendukung perilaku tabel, seperti pada Microsoft Word.

Penting untuk diketahui bahwa elemen tabel menyajikan beberapa properti berbeda yang dapat memengaruhi bagaimana lebar tabel secara keseluruhan, serta sel individual, dihitung:

• Lebar yang disukai di atas meja
• Lebar yang disukai pada sel individual
• Mengizinkan autofit di atas meja

Artikel ini merinci cara kerja berbagai properti penghitungan lebar tabel dan cara mendapatkan kontrol penuh atas penghitungan lebar tabel. Ini adalah sangat berguna untuk diketahui dalam kasus di mana tata letak tabel tidak muncul seperti yang diharapkan.

Dalam kebanyakan kasus, sel yang disukai direkomendasikan daripada lebar tabel. Lebar sel yang disukai lebih sesuai dengan spesifikasi format DOCX serta model Aspose.Words.

Lebar sel sebenarnya adalah nilai yang dihitung untuk format DOCX. Lebar sel yang sebenarnya dapat bergantung pada banyak hal. Misalnya, mengubah margin halaman atau lebar tabel yang disukai dapat memengaruhi lebar sel yang sebenarnya.

Lebar sel yang disukai adalah properti sel yang disimpan dalam dokumen. Itu tidak bergantung pada apa pun dan tidak berubah saat Anda mengubah tabel atau properti sel lainnya.

Semua properti dan metode yang dijelaskan dalam artikel ini terkait dengan cara kerja tabel di Microsoft Word. Jadi dalam banyak kasus, jika Anda membuat tabel secara terprogram tetapi merasa kesulitan untuk membuat tabel yang diinginkan, Anda dapat mencoba membuatnya secara visual di Microsoft Word terlebih dahulu, lalu cukup salin nilai pemformatan ke dalam aplikasi Anda.

Cara Menggunakan Lebar yang Diinginkan

Lebar tabel atau sel individual yang diinginkan ditentukan melalui properti preferred width, yang merupakan ukuran yang ingin disesuaikan oleh elemen. Artinya, lebar yang disukai dapat ditentukan untuk seluruh tabel atau untuk sel individual. Dalam beberapa situasi, lebar ini mungkin tidak dapat disesuaikan dengan tepat, tetapi lebar sebenarnya akan mendekati nilai ini dalam banyak kasus.

Jenis dan nilai lebar pilihan yang sesuai ditetapkan menggunakan metode kelas PreferredWidth:

• metode Auto untuk menentukan otomatis atau “tidak ada lebar yang disukai”
• metode FromPercent untuk menentukan lebar persentase
• metode FromPoints untuk menentukan lebar dalam poin

Gambar-gambar di bawah ini menunjukkan representasi dari preferred width setting features dalam Microsoft Word dan properti yang sesuai dalam Aspose.Words.

Contoh bagaimana opsi ini diterapkan ke tabel nyata dalam dokumen dapat dilihat pada gambar di bawah ini.

Sebelum Anda dapat menggunakan lebar yang diinginkan dalam tabel, Anda harus memastikan bahwa tabel berisi setidaknya satu baris. Ini karena pemformatan tabel seperti itu dalam dokumen Microsoft Word atau dalam dokumen yang dibuat di Aspose.Words disimpan di baris tabel.

Tentukan Tabel atau Lebar Sel yang Disukai

Dalam Aspose.Words, lebar tabel dan sel diatur menggunakan properti Table.PreferredWidth dan properti CellFormat.PreferredWidth, dengan opsi yang tersedia dalam enumerasi PreferredWidthType:

• Auto, yang setara dengan tidak ada set lebar yang disukai
• Percent, yang sesuai dengan elemen relatif terhadap ruang yang tersedia di ukuran jendela atau wadah, dan menghitung ulang nilainya saat lebar yang tersedia berubah
• Points, yang sesuai dengan elemen dengan lebar yang ditentukan dalam poin

Secara default, tabel dapat digambarkan sebagai dipasang ke 100% ruang yang tersedia di halaman. Dalam hal ini, ini berarti tabel akan mencoba mengambil ruang antara margin halaman kiri dan kanan.

Menggunakan properti Table.PreferredWidth akan menyesuaikan lebar pilihannya relatif terhadap penampungnya: halaman, kolom teks, atau sel tabel luar jika itu adalah tabel bersarang.

Contoh kode berikut menunjukkan cara mengatur tabel agar pas secara otomatis hingga 50% dari lebar halaman:

Menggunakan properti CellFormat.PreferredWidth pada sel tertentu akan menyesuaikan lebar pilihannya.

Contoh kode berikut menunjukkan cara mengatur pengaturan lebar pilihan yang berbeda:

Temukan Jenis dan Nilai Lebar yang Disukai

Anda dapat menggunakan properti Type dan Value untuk menemukan detail lebar yang diinginkan dari tabel atau sel yang diinginkan.

Contoh kode berikut menunjukkan cara mengambil tipe lebar yang disukai dari sel tabel:

Cara Mengatur Autofit

Properti AllowAutoFit memungkinkan sel dalam tabel tumbuh dan menyusut sesuai dengan kriteria yang dipilih. Misalnya, Anda dapat menggunakan opsi AutoFit to Window untuk menyesuaikan tabel dengan lebar halaman, dan opsi AutoFit to Content untuk memungkinkan setiap sel membesar atau mengecil sesuai dengan isinya.

Selain itu, properti AllowAutoFit dapat digunakan bersama dengan lebar sel yang disukai untuk memformat sel yang secara otomatis sesuai dengan kontennya, tetapi juga memiliki lebar awal. Jika perlu, lebar sel kemudian dapat tumbuh melewati lebar ini.

Secara default, Aspose.Words menyisipkan tabel baru menggunakan AutoFit to Window. Tabel akan diberi ukuran sesuai dengan lebar halaman yang tersedia. Untuk mengubah ukuran tabel, Anda dapat memanggil metode AutoFit. Metode ini menerima enumerasi AutoFitBehavior yang menentukan jenis autofit yang diterapkan ke tabel.

Penting untuk diketahui bahwa metode autofit sebenarnya adalah pintasan yang menerapkan properti berbeda ke tabel secara bersamaan. Ini adalah properti yang benar-benar memberikan tabel perilaku yang diamati. Kami akan membahas properti ini untuk setiap opsi autofit.

Contoh kode berikut menunjukkan cara mengatur tabel untuk mengecilkan atau menumbuhkan setiap sel sesuai dengan isinya:

AutoFit Tabel ke Jendela

Saat pemasangan otomatis ke jendela diterapkan ke tabel, operasi berikut sebenarnya dilakukan di belakang layar:

1. Properti Table.AllowAutoFit diaktifkan untuk mengubah ukuran kolom secara otomatis agar sesuai dengan konten yang tersedia, menggunakan nilai Table.PreferredWidth sebesar 100%
2. CellFormat.PreferredWidth dihapus dari semua sel tabel
   Perhatikan bahwa ini sedikit berbeda dari perilaku Microsoft Word, di mana lebar pilihan setiap sel diatur ke nilai yang sesuai berdasarkan ukuran dan kontennya saat ini. Aspose.Words tidak memperbarui lebar yang disukai sehingga hanya dihapus saja.
3. Lebar kolom dihitung ulang untuk konten tabel saat ini-hasil akhirnya adalah tabel yang menempati seluruh lebar yang tersedia
4. Lebar kolom dalam tabel berubah secara otomatis saat pengguna mengedit teks

Contoh kode berikut menunjukkan cara menyesuaikan tabel secara otomatis ke lebar halaman:

AutoFit Tabel ke Konten

Saat tabel melengkapi konten secara otomatis, langkah-langkah berikut sebenarnya dilakukan di belakang layar:

1. Properti Table.AllowAutoFit diaktifkan untuk mengubah ukuran setiap sel secara otomatis sesuai dengan kontennya

2. Lebar tabel yang disukai dihapus dari Table.PreferredWidth, CellFormat.PreferredWidth dihapus untuk setiap sel tabel

   Perhatikan bahwa opsi isiotomatis ini menghapus lebar yang diinginkan dari sel, seperti pada Microsoft Word. Jika Anda ingin mempertahankan ukuran kolom dan menambah atau mengurangi kolom agar sesuai dengan konten, Anda harus menyetel properti Table.AllowAutoFit ke True sendiri daripada menggunakan pintasan autofit.

3. Lebar kolom dihitung ulang untuk konten tabel saat ini-hasil akhirnya adalah tabel dengan lebar kolom dan lebar seluruh tabel diubah ukurannya secara otomatis agar paling sesuai dengan konten saat pengguna mengedit teks

Contoh kode berikut menunjukkan cara menambahkan tabel secara otomatis ke kontennya:

Nonaktifkan AutoFit dalam Tabel dan Gunakan Lebar Kolom Tetap

Jika tabel menonaktifkan autofit dan lebar kolom tetap digunakan sebagai gantinya, langkah-langkah berikut akan dilakukan:

1. properti Table.AllowAutoFit dinonaktifkan sehingga kolom tidak bertambah atau menyusut sesuai kontennya
2. Lebar yang disukai dari seluruh tabel dihapus dari Table.PreferredWidth, CellFormat.PreferredWidth dihapus dari semua sel tabel
3. Hasil akhirnya adalah tabel yang lebar kolomnya ditentukan oleh properti CellFormat.Width, dan kolomnya tidak diubah ukurannya secara otomatis saat pengguna memasukkan teks atau saat halaman diubah ukurannya

Perhatikan bahwa jika tidak ada lebar yang ditentukan untuk CellFormat.Width, nilai default satu inci (72 poin) digunakan.

Contoh kode berikut menunjukkan cara menonaktifkan autofit dan mengaktifkan lebar tetap untuk tabel yang ditentukan:

Urutan Prioritas saat Menghitung Lebar Sel

Aspose.Words memungkinkan pengguna untuk menentukan lebar tabel atau sel melalui beberapa objek, termasuk CellFormat - properti Width sebagian besar tersisa dari versi sebelumnya, namun tetap berguna untuk menyederhanakan pengaturan lebar sel.

Penting untuk diketahui bahwa properti CellFormat.Width bekerja secara berbeda tergantung pada properti width mana yang sudah ada dalam tabel.

Aspose.Words menggunakan urutan berikut untuk menghitung lebar sel:

Pesan	Properti	Deskripsi
	AllowAutoFit ditentukan	Jika AutoFit diaktifkan: – tabel dapat bertambah melewati lebar yang diinginkan untuk mengakomodasi konten-biasanya tidak menyusut di bawah lebar yang diinginkan - setiap perubahan pada nilai CellFormat.Width diabaikan dan sel akan sesuai dengan isinya sebagai gantinya
	PreferredWidthType dengan nilai Points atau Percent	CellFormat.Width diabaikan
	PreferredWidthType dengan nilai Auto	Nilai dari CellFormat.Width disalin dan menjadi lebar pilihan sel (dalam poin)

Setiap perubahan pada properti width tidak diperbarui dalam lebar yang disukai dan sebagai gantinya harus diterapkan pada lebar yang disukai.

Saat membuat tata letak tabel tetap, tentukan lebar sel. Sel tanpa lebar tidak dapat disimpan ke format DOC. Format dokumen selain DOC, seperti DOCX, memungkinkan, pada prinsipnya, menyimpan sel tanpa lebar dalam tata letak tabel tetap.

Izinkan jarak antar sel

Anda bisa mendapatkan atau mengatur ruang tambahan di antara sel tabel yang mirip dengan opsi" Spasi sel " di Microsoft Word. Ini dapat dilakukan dengan menggunakan properti AllowCellSpacing.

Contoh bagaimana opsi ini diterapkan ke tabel nyata dalam dokumen dapat dilihat pada gambar di bawah ini.

Contoh kode berikut menunjukkan cara mengatur jarak antar sel:

Terapkan Batas dan Bayangan

Batas dan bayangan dapat diterapkan ke seluruh tabel menggunakan Table.SetBorder, Table.SetBorders, dan Table.SetShading, atau hanya ke sel tertentu menggunakan CellFormat.Borders dan CellFormat.Shading. Selain itu, batas baris dapat diatur menggunakan RowFormat.Borders, namun bayangan tidak dapat diterapkan dengan cara ini.

Gambar-gambar di bawah ini menunjukkan pengaturan batas dan bayangan di Microsoft Word dan properti terkait di Aspose.Words.

Contoh kode berikut menunjukkan cara memformat tabel dan sel dengan batas dan bayangan yang berbeda: