SetStructElemHeaders

Tagged PDF, Pristupačnost

Opis

Postavlja /Headers atribut (vlasnik atributa Table) na elementu strukture trenutno otvorenom na steku tagova. Atribut povezuje trenutnu ćeliju podatka ili zaglavlja tabele sa jednom ili više ćelija zaglavlja tabele identifikovanih svojim element ID-jevima. Koristi se za opis složenih struktura tabela koje se ne mogu izvesti samo iz pozicije. Pozovite ovo nakon BeginTag ili BeginTagEx i pre EndTag

Sintaksa

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	Lista ElemID-eva TH ćelija razdvojenih zarezima, koje su kolonska ili redna zaglavlja za trenutnu TD ili TH ćeliju. Svaki ID mora poklapati ElemID dodeljen TH elementu funkcijom SetStructElemID ranije u istom dokumentu. Praznine oko zareza se ignorišu. Primer: `TH-ProductName,TH-Price`

Povratna vrednost

Vraća 1 u slučaju uspeha. Vraća 0 ako nijedan dokument nije otvoren ili ako nijedan tag nije trenutno otvoren na steku tagova

Napomene

Ova funkcija je istovetna pozivu AddTagAttribute sa Owner=Table, Name=Headers i istom listom ID-jeva razdvojenih zapetom kao Value. Atribut se upisuje kao /Headers niz PDF tekstualnih stringova u /A rečniku atributa elementa strukture

Atribut /Headers definisan je u ISO 32000-1 §14.8.5.7.2 (vlasnik atributa Table). Za jednostavne tabele gde su zaglavlja kolona direktno iznad svojih ćelija podataka, atribut /Scope postavljen pomoću SetStructElemScope je obično dovoljan. Koristite /Headers za nepravilne tabele sa ćelijama koje se protežu kroz više kolona/redova ili sa višeslovnim zaglavljima.

PDF/UA-1 (ISO 14289-1 §7.10) zahteva da svaka TD ćelija bude eksplicitno povezana sa svojim ćelijama zaglavlja u tabelama gde se ta veza ne može utvrditi samo iz redosleda čitanja.

Primer

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

Vidi takođe

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode