SetStructElemHeaders

PDF Terlabeli, Aksesibilitas

Deskripsi

Mengeset attribute /Headers (owner attribute Table) pada structure element yang sedang terbuka di tag stack. Attribute mengasosiasikan cell data atau header tabel saat ini dengan satu atau lebih cell header tabel yang diidentifikasi lewat elemen ID-nya. Ini dipakai untuk mendeskripsikan struktur tabel kompleks yang tidak bisa disimpulkan dari posisi saja. Panggil ini setelah BeginTag atau BeginTagEx dan sebelum EndTag

Sintaks

Delphi

Function TPDFlib.SetStructElemHeaders(Const Headers: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemHeaders(Headers As String) As Long

DLL

int DLSetStructElemHeaders(int InstanceID, const wchar_t * Headers);

Parameter

Headers	Daftar elemen ID dipisah koma dari cell TH yang menjadi header kolom atau baris bagi cell TD atau TH saat ini. Setiap ID harus cocok dengan ElemID yang ditugaskan ke elemen TH melalui SetStructElemID sebelumnya di dokumen yang sama. Whitespace di sekitar koma diabaikan. Contoh: `TH-ProductName,TH-Price`

Nilai kembali

Mengembalikan 1 jika sukses. Mengembalikan 0 jika tidak ada dokumen yang terbuka atau tidak ada tag yang sedang terbuka di tag stack

Catatan

Fungsi ini setara dengan memanggil AddTagAttribute dengan Owner=Table, Name=Headers, dan daftar ID dipisah koma yang sama sebagai Value. Attribute ditulis sebagai array /Headers berisi text string PDF di dictionary attribute /A structure element

Attribute /Headers didefinisikan di ISO 32000-1 §14.8.5.7.2 (owner attribute Table). Untuk tabel sederhana yang header kolomnya berada tepat di atas cell datanya, attribute /Scope yang diset lewat SetStructElemScope umumnya sudah cukup. Gunakan /Headers untuk tabel tidak beraturan dengan cell yang melintasi kolom atau header multi-level

PDF/UA-1 (ISO 14289-1 §7.10) mewajibkan setiap cell TD secara eksplisit terasosiasi dengan cell header-nya pada tabel yang asosiasinya tidak bisa disimpulkan dari urutan baca saja

Contoh

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Lihat juga

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode