SetStructElemHeaders

Pažymėtas PDF, pritaikymas neįgaliesiems

Aprašymas

Nustato /Headers atributą (Table atributų savininką) struktūros elementui, šiuo metu atvertam žymų dėklyje. Atributas susieja esamąjį lentelės duomenų arba antraštės langelį su vienu ar keliais lentelės antraščių langeliais, identifikuojamais jų elementų ID. Tai naudojama sudėtingosioms lentelių struktūroms aprašyti, kurių negalima išvesti vien iš padėties. Iškvieskite tai po BeginTag arba BeginTagEx ir prieš 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);

Parametrai

Headers	Kableliais atskirtas tų TH langelių elementų ID sąrašas, kurie yra esamojo TD arba TH langelio stulpelio arba eilutės antraštės. Kiekvienas ID turi atitikti ElemID, anksčiau tame pačiame dokumente priskirtą TH elementui per SetStructElemID. Tarpai aplink kablelius ignoruojami. Pavyzdys: `TH-ProductName,TH-Price`

Grąžinama reikšmė

Sėkmės atveju grąžina 1. Grąžina 0, jei neatvertas dokumentas arba žymų dėkle šiuo metu neatverta jokia žymė

Pastabos

Ši funkcija lygi AddTagAttribute iškvietimui su Owner=Table, Name=Headers ir ta pačia kableliais atskirta ID sąrašu kaip Value. Atributas rašomas kaip /Headers PDF teksto eilučių masyvas struktūros elemento /A atributų žodyne

/Headers atributas apibrėžtas ISO 32000-1 §14.8.5.7.2 (lentelės atributų savininkas). Paprastoms lentelėms, kur stulpelių antraštės yra tiesiai virš savo duomenų langelių, paprastai pakanka /Scope atributo, nustatomo per SetStructElemScope. /Headers naudokite netaisyklingoms lentelėms su apimantysis langeliais ar kelių lygių antraštėmis.

PDF/UA-1 (ISO 14289-1 §7.10) reikalauja, kad kiekvienas TD langelis aiškiai susietų su savo antraščių langeliais tose lentelėse, kur sąsajos negalima nustatyti vien iš skaitymo tvarkos.

Pavyzdys

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

Taip pat žiūrėkite

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode