SetStructElemHeaders

Označeni PDF, Pristupačnost

Opis

Postavlja atribut /Headers (vlasnik atributa tablice) na strukturnom elementu trenutačno otvorenom na stogu oznaka. Atribut povezuje trenutačnu podatkovnu ili naslovnu ćeliju tablice s jednom ili više naslovnih ćelija tablice identificiranih njihovim ID-jevima elemenata. Upotrebljava se za opis složenih struktura tablica koje se ne mogu zaključiti samo iz položaja. Pozovite ovo nakon BeginTag ili BeginTagEx, a prije 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	Popis ID-jeva elemenata TH ćelija odvojen zarezima; te su ćelije stupčani ili redčani naslovi za trenutačnu TD ili TH ćeliju. Svaki ID mora odgovarati ElemID dodijeljenom TH elementu funkcijom SetStructElemID ranije u istom dokumentu. Razmak oko zareza zanemaruje se. Primjer: `TH-ProductName,TH-Price`

Povratna vrijednost

Vraća 1 pri uspjehu. Vraća 0 ako nije otvoren dokument ili na stogu oznaka trenutačno nije otvorena nijedna oznaka

Napomene

Ova je funkcija ekvivalentna pozivu AddTagAttribute s Owner=Table, Name=Headers i istim popisom ID-jeva odvojenim zarezima kao Value. Atribut se zapisuje kao niz /Headers PDF tekstnih nizova u rječniku atributa /A strukturnog elementa

Atribut /Headers definiran je u ISO 32000-1 §14.8.5.7.2 (Table attribute owner). U jednostavnim tablicama u kojima su zaglavlja stupaca izravno iznad svojih ćelija podataka obično je dovoljan atribut /Scope postavljen putem SetStructElemScope. /Headers upotrijebite za nepravilne tablice sa spojenim ćelijama ili višerazinskim zaglavljima.

PDF/UA-1 (ISO 14289-1 §7.10) zahtijeva da svaka ćelija TD bude izričito povezana sa svojim ćelijama zaglavlja u tablicama u kojima se povezanost ne može utvrditi samo iz redoslijeda čitanja.

Primjer

// 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đer

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode