Antarmuka ITextRow (tom.h)
Antarmuka ITextRow menyediakan metode untuk menyisipkan satu atau beberapa baris tabel yang identik, dan untuk mengambil dan mengubah properti baris tabel. Untuk menyisipkan baris nonidentik, panggil ITextRow::Insert untuk setiap konfigurasi baris yang berbeda.
Warisan
Antarmuka ITextRow mewarisi dari antarmuka IDispatch . ITextRow juga memiliki jenis anggota ini:
Metode
Antarmuka ITextRow memiliki metode ini.
|
ITextRow::Apply Menerapkan atribut pemformatan objek baris teks ini ke baris yang ditentukan di ITextRange2 terkait. |
|
ITextRow::CanChange Menentukan apakah perubahan dapat dilakukan pada baris ini. |
|
ITextRow::GetAlignment Mendapatkan perataan horizontal baris. |
|
ITextRow::GetCellAlignment Mendapatkan perataan vertikal sel aktif. |
|
ITextRow::GetCellBorderColors Mendapatkan warna batas sel aktif. |
|
ITextRow::GetCellBorderWidths Mendapatkan lebar batas sel aktif. |
|
ITextRow::GetCellColorBack Mendapatkan warna latar belakang sel aktif. |
|
ITextRow::GetCellColorFore Mendapatkan warna latar depan sel aktif. |
|
ITextRow::GetCellCount Mendapatkan hitungan sel dalam baris ini. |
|
ITextRow::GetCellCountCache Mendapatkan jumlah sel yang di-cache untuk baris ini. |
|
ITextRow::GetCellIndex Mendapatkan indeks sel aktif untuk mendapatkan atau mengatur parameter. |
|
ITextRow::GetCellMargin Mendapatkan margin sel dari baris ini. |
|
ITextRow::GetCellMergeFlags Mendapatkan bendera gabungan sel aktif. |
|
ITextRow::GetCellShading Mendapatkan bayangan sel aktif. |
|
ITextRow::GetCellVerticalText Mendapatkan pengaturan teks vertikal dari sel aktif. |
|
ITextRow::GetCellWidth Mendapatkan lebar sel aktif. |
|
ITextRow::GetHeight Mendapatkan tinggi baris. |
|
ITextRow::GetIndent Mendapatkan inden baris ini. |
|
ITextRow::GetKeepTogether Mendapatkan apakah baris ini diizinkan untuk dipecah di seluruh halaman. |
|
ITextRow::GetKeepWithNext Mendapatkan apakah baris ini akan muncul di halaman yang sama dengan baris yang mengikutinya. |
|
ITextRow::GetNestLevel Mendapatkan tingkat sarang tabel. |
|
ITextRow::GetProperty Mendapatkan nilai properti yang ditentukan. (ITextRow.GetProperty) |
|
ITextRow::GetRTL Mendapatkan apakah baris ini memiliki orientasi kanan-ke-kiri. |
|
ITextRow::Insert Menyisipkan baris, atau baris, di lokasi yang diidentifikasi oleh objek ITextRange2 terkait. |
|
ITextRow::IsEqual Membandingkan dua baris tabel untuk menentukan apakah baris tersebut memiliki properti yang sama. |
|
ITextRow::Reset Mereset baris. |
|
ITextRow::SetAlignment Mengatur perataan horizontal baris. |
|
ITextRow::SetCellAlignment Mengatur perataan vertikal sel aktif. |
|
ITextRow::SetCellBorderColors Mengatur warna batas sel aktif. |
|
ITextRow::SetCellBorderWidths Mengatur lebar batas sel aktif. |
|
ITextRow::SetCellColorBack Mengatur warna latar belakang sel aktif. |
|
ITextRow::SetCellColorFore Mengatur warna latar depan sel aktif. |
|
ITextRow::SetCellCount Mengatur jumlah sel dalam baris. |
|
ITextRow::SetCellCountCache Mengatur jumlah sel yang di-cache untuk baris. |
|
ITextRow::SetCellIndex Mengatur indeks sel aktif. |
|
ITextRow::SetCellMargin Mengatur margin sel dari baris. |
|
ITextRow::SetCellMergeFlags Mengatur bendera gabungan sel aktif. |
|
ITextRow::SetCellShading Mengatur bayangan sel aktif. |
|
ITextRow::SetCellVerticalText Mengatur pengaturan teks vertikal dari sel aktif. |
|
ITextRow::SetCellWidth Mengatur lebar sel aktif dalam twips. |
|
ITextRow::SetHeight Mengatur tinggi baris. |
|
ITextRow::SetIndent Mengatur inden baris. |
|
ITextRow::SetKeepTogether Mengatur apakah baris ini diizinkan untuk dipecah di seluruh halaman. |
|
ITextRow::SetKeepWithNext Mengatur apakah baris akan muncul di halaman yang sama dengan baris yang mengikutinya. |
|
ITextRow::SetProperty Mengatur nilai properti yang ditentukan. (ITextRow.SetProperty) |
|
ITextRow::SetRTL Menyetel apakah baris ini memiliki orientasi kanan-ke-kiri. |
Keterangan
Untuk memilih tabel, baris, atau sel, gunakan ITextRange::Expand, dengan parameter Unit masing-masing diatur ke tomTable, tomRow, atau tomCell. Unit-unit ini juga dapat digunakan dengan metode ITextRange::Move untuk menavigasi dan memilih beberapa baris atau sel.
Beberapa properti ITextRow berlaku untuk seluruh baris, seperti perataan baris. Selain itu, ada sejumlah properti, seperti perataan sel, yang berlaku untuk sel dengan indeks yang diatur melalui metode ITextRow::SetCellIndex . Sel ini disebut sebagai sel aktif.
ITextRow berfungsi mirip dengan ITextPara2, tetapi tidak mengubah dokumen hingga metode ITextRow::Apply atau ITextRow::Insert dipanggil. Selain itu, parameter baris dan sel selalu aktif, yaitu, mereka tidak dapat memiliki nilai tomDefault.
Pada inisialisasi, objek ITextRow memperoleh properti baris tabel, jika ada, di akhir aktif ITextRange2 terkait. Metode ITextRow::Reset dapat digunakan untuk memperbarui properti ini ke nilai saat ini untuk objek ITextRange2 .
Tabel kontrol edit yang kaya terdiri dari urutan baris tabel, yang, pada gilirannya, terdiri dari urutan paragraf. Baris tabel dimulai dengan paragraf pemisah dua karakter khusus U+FFF9 U+000D dan diakhir dengan paragraf pemisah dua karakter U+FFFB U+000D. Setiap sel dihentikan oleh tanda sel U+0007, yang diperlakukan sebagai tanda akhir paragraf keras sama seperti U+000D (CR). Parameter baris tabel dan sel diperlakukan sebagai pemformatan paragraf khusus dari pemisah baris tabel. Parameter sel disimpan dalam versi array tab yang diperluas. Format ini memungkinkan tabel ditumpuk dalam tabel lain dan diizinkan untuk masuk ke lima belas tingkat dalam.
Arsitekturnya cukup fleksibel karena setiap baris tabel dapat memiliki parameter baris tabel yang valid, terlepas dari parameter untuk baris lain (kecuali untuk bendera penggabungan vertikal). Misalnya, jumlah sel dan inden awal baris tabel dapat berbeda, tidak seperti dalam HTML yang memiliki format persegi panjang n×m dengan semua baris dimulai dari inden yang sama.
Di sisi lain, tidak ada deskripsi tabel formal yang disimpan di mana saja. Informasi seperti jumlah baris harus dicari dengan menavigasi melalui tabel. Misalnya, jumlah baris dalam tabel dapat diperoleh dengan memanggil ITextRange::StartOf (tomTable, tomFalse, NULL) untuk berpindah ke awal tabel saat ini lalu memanggil ITextRange::Move (tomRow, tomForward, &dcRow). Kuantitas &dcRow + 1 kemudian berisi hitungan baris dalam tabel, karena pemindahan dengan kenaikan tomRow tidak bergerak melampaui baris tabel terakhir.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | tom.h |