SetStructElemHeaders

Tagget PDF, tilgjengelighet

Beskrivelse

Setjer /Headers-attributtet (Table attribute owner) på strukturelementet som står åpent på tag-stakken akkurat nå. Attributtet knytter gjeldende tabelldata- eller overskriftscelle til én eller flere tabelloverskriftsceller identifisert ved sine element-ID-er. Dette brukes til å beskrive komplekse tabellstrukturer som ikke kan utledes av posisjon alene. Kall denne etter BeginTag eller BeginTagEx og før EndTag

Syntaks

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

Parametere

Headers	En kommaatskilt liste over element-ID-er til TH-cellene som er kolonne- eller radoverskrifter for gjeldende TD- eller TH-celle. Hver ID må matche en ElemID tildelt et TH-element via SetStructElemID tidligere i samme dokument. Mellomrom rundt kommaer ignoreres. Eksempel: `TH-ProductName,TH-Price`

Returverdi

Returnerer 1 ved suksess. Returnerer 0 hvis ingen dokument er åpent eller ingen tag står øverst på tag-stakken

Merknader

Denne funksjonen tilsvarer å kalle AddTagAttribute med Owner=Table, Name=Headers og samme kommaatskilte ID-liste som Value. Attributtet skrives som en /Headers-matrise av PDF-tekststrenger i strukturelementets /A-attributtordbok

Attributten /Headers er definert i ISO 32000-1 §14.8.5.7.2 (Table-attributteier). For enkle tabeller der kolonnetopptekster ligger rett over datacellene er /Scope-attributten satt via SetStructElemScope vanligvis tilstrekkelig. Bruk /Headers for uregelrette tabeller med celler som spenner over flere, eller topptekster på flere nivåer

PDF/UA-1 (ISO 14289-1 §7.10) krever at hver TD-celle eksplisitt knyttes til sine topptekstceller i tabeller der koblingen ikke kan fastslås fra leserekkefølgen alene

Eksempel

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

Se også

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode