SetStructElemHeaders

Tagovaný PDF, prístupnosť

Opis

Nastaví atribút /Headers (vlastník atribútov Table) na štruktúrnom prvku aktuálne otvorenom na zásobníku tagov. Atribút priradí aktuálnu dátovú či hlavičkovú bunku tabuľky k jednej alebo viacerým hlavičkovým bunkám tabuľky identifikovaným ich ID prvkov. Používa sa na popis komplexných štruktúr tabuliek, ktoré sa nedajú odvodiť len z pozície. Zavolajte to po BeginTag alebo BeginTagEx a pred EndTag.

Syntax

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

Parametre

Headers	Zoznam ID prvkov TH buniek oddelený čiarkami, ktoré sú stĺpcovými či riadkovými hlavičkami pre aktuálnu bunku TD alebo TH. Každé ID sa musí zhodovať s ElemID priradeným prvku TH cez SetStructElemID skôr v tom istom dokumente. Prázdne znaky okolo čiariok sa ignorujú. Príklad: `TH-ProductName,TH-Price`.

Návratová hodnota

Vráti 1 pri úspechu. Vráti 0, ak nie je otvorený žiadny dokument alebo sa na zásobníku tagov práve neotvára žiadny tag

Poznámky

Táto funkcia je ekvivalentom volania AddTagAttribute s Owner=Table, Name=Headers a tým istým zoznamom ID oddeleným čiarkami ako Value. Atribút sa zapisuje ako pole /Headers textových reťazcov PDF v atribútovom slovníku /A štruktúrneho prvku.

Atribút /Headers je definovaný v ISO 32000-1 §14.8.5.7.2 (Table attribute owner). V jednoduchých tabuľkách, kde sú hlavičky stĺpcov priamo nad svojimi údajovými bunkami, zvyčajne stačí atribút /Scope nastavený cez SetStructElemScope. /Headers použite pri nepravidelných tabuľkách so spojenými bunkami alebo viacúrovňovými hlavičkami.

PDF/UA-1 (ISO 14289-1 §7.10) vyžaduje, aby bola každá bunka TD výslovne spojená so svojimi bunkami hlavičiek v tabuľkách, kde sa spojenie nedá určiť len z poradia čítania.

Príklad

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

Pozri tiež

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode