SetStructElemHeadersA

Getagde PDF, toegankelijkheid

Beschrijving

Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan SetStructElemHeaders en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Zet het attribuut /Headers (Table-attribuuteigenaar) op het structuurelement dat momenteel open staat op de tagstack. Het attribuut koppelt de huidige tabeldata- of headercel aan een of meer tabelheadercellen die via hun element-ID's zijn geïdentificeerd. Dit wordt gebruikt om complexe tabelstructuren te beschrijven die niet alleen uit positie zijn af te leiden. Roep dit aan na BeginTag of BeginTagEx en vóór EndTag

Syntaxis

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

Parameters

Headers	Een kommagescheiden lijst met element-ID's van de TH-cellen die kolom- of rijkoppen zijn voor de huidige TD- of TH-cel. Elke ID moet overeenkomen met een ElemID dat eerder in hetzelfde document via SetStructElemID aan een TH-element is toegekend. Witruimte rond komma's wordt genegeerd. Voorbeeld: `TH-ProductName,TH-Price`

Retourwaarde

Retourneert 1 bij succes. Retourneert 0 als er geen document is geopend of momenteel geen tag op de tagstack geopend is

Opmerkingen

Deze functie is gelijk aan het aanroepen van AddTagAttribute met Owner=Table, Name=Headers en dezelfde kommagescheiden ID-lijst als Value. Het attribuut wordt weggeschreven als /Headers-array van PDF-tekststrings in de /A-attribuutwoordenboek van het structuurelement

Het attribuut /Headers is gedefinieerd in ISO 32000-1 §14.8.5.7.2 (Table-attribuuteigenaar). Voor eenvoudige tabellen waarin kolomkoppen direct boven hun datacellen staan is het via SetStructElemScope gezette attribuut /Scope meestal voldoende. Gebruik /Headers voor onregelmatige tabellen met overspannende cellen of headers op meerdere niveaus

PDF/UA-1 (ISO 14289-1 §7.10) eist dat elke TD-cel expliciet aan zijn headercellen wordt gekoppeld in tabellen waar die koppeling niet uit de leesvolgorde alleen valt af te leiden

Voorbeeld

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

Zie ook

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode