SetStructElemHeaders

PDF etichetat, Accesibilitate

Descriere

Setează atributul /Headers (proprietarul de atribute Table) pe elementul de structură deschis în prezent pe stiva de tag-uri. Atributul asociază celula de date sau de antet de tabel curentă cu una sau mai multe celule de antet de tabel identificate prin ID-urile lor de element. Este folosit pentru a descrie structuri de tabele complexe care nu pot fi deduse doar din poziție. Apelați asta după BeginTag sau BeginTagEx și înainte de EndTag

Sintaxă

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);

Parametri

Headers	O listă separată prin virgule de ID-uri de element ale celulelor TH care sunt antete de coloană sau de rând pentru celula TD sau TH curentă. Fiecare ID trebuie să corespundă unui ElemID asignat unui element TH prin SetStructElemID mai devreme în același document. Spațiile albe din jurul virgulelor sunt ignorate. Exemplu: `TH-ProductName,TH-Price`

Valoare returnată

Returnează 1 în caz de succes. Returnează 0 dacă niciun document nu este deschis sau dacă nu există niciun tag deschis în stiva de tag-uri

Observații

Această funcție este echivalentă cu apelarea AddTagAttribute cu Owner=Table, Name=Headers și aceeași listă de ID-uri separate prin virgule ca Value. Atributul este scris ca vector /Headers de șiruri de text PDF în dicționarul de atribute /A al elementului de structură

Atributul /Headers este definit în ISO 32000-1 §14.8.5.7.2 (deținător de atribute Table). Pentru tabelele simple, unde antetele de coloană sunt direct deasupra celulelor lor de date, atributul /Scope setat prin SetStructElemScope este de obicei suficient. Folosiți /Headers pentru tabelele neregulate cu celule care se întind pe mai multe coloane sau cu antete pe mai multe niveluri

PDF/UA-1 (ISO 14289-1 §7.10) cere ca fiecare celulă TD să fie asociată explicit cu celulele ei de antet în tabelele unde asocierea nu poate fi stabilită doar din ordinea de citire

Exemplu

// 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;

Consultați și

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode