Bekerja dengan Bentuk
Topik ini membahas cara bekerja secara terprogram dengan bentuk menggunakan Aspose.Words.
Bentuk di Aspose.Words mewakili objek di lapisan gambar, seperti BentukOtomatis, kotak teks, bentuk bebas, objek OLE, kontrol ActiveX, atau gambar. Dokumen Word bisa berisi satu atau lebih bentuk berbeda. Bentuk dokumen diwakili oleh kelas Shape.
Memasukkan Bentuk Menggunakan Pembuat Dokumen
Anda dapat menyisipkan bentuk sebaris dengan tipe dan ukuran tertentu serta bentuk mengambang bebas dengan posisi, ukuran, dan jenis bungkus teks tertentu ke dalam dokumen menggunakan metode insert_shape. Metode insert_shape memungkinkan penyisipan bentuk DML ke dalam model dokumen. Dokumen harus disimpan dalam format yang mendukung bentuk DML, jika tidak, node tersebut akan dikonversi ke bentuk VML, saat menyimpan dokumen.
Contoh kode berikut menunjukkan cara menyisipkan tipe bentuk ini ke dalam dokumen:
Setel Rasio Aspek Terkunci
Dengan menggunakan Aspose.Words, Anda dapat menentukan apakah rasio aspek bentuk dikunci melalui properti aspect_ratio_locked.
Contoh kode berikut menunjukkan cara bekerja dengan properti AspectRatioLocked:
Atur Tata Letak Bentuk Di Sel
Anda juga dapat menentukan apakah bentuk ditampilkan di dalam tabel atau di luar tabel menggunakan properti is_layout_in_cell.
Contoh kode berikut menunjukkan cara bekerja dengan properti IsLayoutInCell:
Buat Snip Sudut Persegi Panjang
Anda dapat membuat persegi panjang sudut snip menggunakan Aspose.Words. Tipe bentuknya adalah SINGLE_CORNER_SNIPPED, TOP_CORNERS_SNIPPED, DIAGONAL_CORNERS_SNIPPED, TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPED, SINGLE_CORNER_ROUNDED, TOP_CORNERS_ROUNDED, dan DIAGONAL_CORNERS_ROUNDED.
Bentuk DML dibuat menggunakan metode insert_shape dengan tipe bentuk berikut. Tipe ini tidak dapat digunakan untuk membuat bentuk VML. Upaya membuat bentuk dengan menggunakan konstruktor publik kelas Shape memunculkan pengecualian “NotSupportedException”.
Contoh kode berikut menunjukkan cara menyisipkan tipe bentuk ini ke dalam dokumen:
Dapatkan Poin Batas Bentuk Aktual
Dengan menggunakan Aspose.Words API, Anda bisa mendapatkan lokasi dan ukuran bentuk yang berisi blok dalam titik, relatif terhadap jangkar bentuk paling atas. Untuk melakukan ini, gunakan properti bounds_in_points.
Contoh kode berikut menunjukkan cara bekerja dengan properti BoundsInPoints:
Tentukan Jangkar Vertikal
Anda dapat menentukan perataan vertikal teks dalam bentuk menggunakan properti vertical_anchor.
Contoh kode berikut menunjukkan cara bekerja dengan properti VerticalAnchor:
Deteksi Bentuk SmartArt
Aspose.Words juga memungkinkan untuk mendeteksi apakah Bentuk memiliki objek SmartArt. Untuk melakukan ini, gunakan properti properti has_smart_art.
Contoh kode berikut menunjukkan cara bekerja dengan properti HasSmartArt:
Masukkan Aturan Horizontal ke dalam Dokumen
Anda dapat menyisipkan bentuk aturan horizontal ke dalam dokumen menggunakan metode insert_horizontal_rule.
Contoh kode berikut menunjukkan cara melakukannya:
Aspose.Words API menyediakan properti horizontal_rule_format untuk mengakses properti bentuk aturan horizontal. Kelas HorizontalRuleFormat memperlihatkan properti dasar seperti height, color, no_shade, dll. untuk pemformatan aturan horizontal.
Contoh kode berikut menunjukkan cara mengatur HorizontalRuleFormat:
Sisipkan Objek OLE sebagai Ikon
Aspose.Words API menyediakan fungsi Bentuk.masukkan_ole_object_as_icon untuk menyisipkan objek OLE yang tertanam atau tertaut sebagai ikon ke dalam dokumen. Fungsi ini memungkinkan menentukan file ikon dan keterangannya. Jenis objek OLE harus dideteksi menggunakan ekstensi file.
Contoh kode berikut menunjukkan cara mengatur penyisipan objek OLE sebagai Ikon ke dalam dokumen:
Impor Bentuk dengan Math XML sebagai Bentuk ke DOM
Anda dapat menggunakan properti convert_shape_to_office_math untuk mengonversi bentuk dengan EquationXML ke objek Office Math. Nilai default properti ini sesuai dengan perilaku MS Word yaitu bentuk dengan persamaan XML tidak dikonversi ke objek matematika Office.
Contoh kode berikut memperlihatkan cara mengonversi bentuk menjadi objek Office Math: