SetStructElemHeadersA

Taggad PDF, tillgänglighet

Beskrivning

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med SetStructElemHeaders och strängargument tolkas med aktuell SetAnsiMode-kod sida

Sätter /Headers-attributet (Table-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Attributet knyter den aktuella tabelldata- eller rubrikcellen till en eller flera tabellrubrikceller identifierade via sina element-ID:n. Det används för att beskriva komplexa tabellstrukturer som inte kan slutas ut enbart från position. Anropa detta efter BeginTag eller BeginTagEx och före EndTag

Syntax

Delphi

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

DLL

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

Parametrar

Headers	En kommaavgränsad lista med element-ID:n för de TH-celler som är kolumn- eller radrubriker för den aktuella TD- eller TH-cellen. Varje ID måste matcha ett ElemID som tilldelats ett TH-element via SetStructElemID tidigare i samma dokument. Whitespace runt kommatecken ignoreras. Exempel: `TH-ProductName,TH-Price`

Returvärde

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Anmärkningar

Den här funktionen är ekvivalent med att anropa AddTagAttribute med Owner=Table, Name=Headers och samma kommaavgränsade ID-lista som Value. Attributet skrivs som en /Headers-array av PDF-textsträngar i strukturelementets /A-attributdictionary

Attributet /Headers är definierat i ISO 32000-1 §14.8.5.7.2 (Table-attributägare). För enkla tabeller där kolumnrubriker ligger direkt ovanför sina dataceller räcker attributet /Scope som sätts via SetStructElemScope i allmänhet. Använd /Headers för oregelbundna tabeller med spännande celler eller flernivårubriker

PDF/UA-1 (ISO 14289-1 §7.10) kräver att varje TD-cell uttryckligen kopplas till sina rubrikceller i tabeller där kopplingen inte kan avgöras enbart ur läsordningen

Exempel

// 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 även

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode