SetStructElemHeaders

Označeni PDF, Dostopnost

Opis

Na strukturnem elementu, trenutno odprtemu na skladu oznak, nastavi atribut /Headers (lastnik atributov Table). Atribut poveže trenutno podatkovno ali glavno celico tabele z eno ali več glavnimi celicami tabele, identificiranimi po njihovih ID-jih elementov. Uporablja se za opis zapletenih struktur tabel, ki jih iz samega položaja ni mogoče sklepati. Pokličite za BeginTag ali BeginTagEx in pred EndTag

Sintaksa

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

Parametri

Headers	Z vejicami ločen seznam ID-jev elementov celic TH, ki so glave stolpcev ali vrstic za trenutno celico TD ali TH. Vsak ID se mora ujemati z ElemID, dodeljenim TH elementu prek SetStructElemID prej v istem dokumentu. Presledki okoli vejic se ignorirajo. Primer: `TH-ProductName,TH-Price`

Vrnjena vrednost

Ob uspehu vrne 1. Vrne 0, če noben dokument ni odprt ali na skladu oznak trenutno ni odprta nobena oznaka

Opombe

Ta funkcija je enakovredna klicu AddTagAttribute z Owner=Table, Name=Headers in istim z vejicami ločenim seznamom ID kot Value. Atribut se zapiše kot tabela /Headers besedilnih nizov PDF v slovarju atributov /A strukturnega elementa

Atribut /Headers je definiran v ISO 32000-1 §14.8.5.7.2 (lastnik atributov tabele). Za preproste tabele, kjer so glave stolpcev neposredno nad svojimi podatkovnimi celicami, je običajno zadost atribut /Scope, nastavljen prek SetStructElemScope. /Headers uporabite za nepravilne tabele s celicami, raztegnjenimi čez stolpce, ali z večnivojskimi glavami

PDF/UA-1 (ISO 14289-1 §7.10) zahteva, da je vsaka celica TD v tabelah, kjer povezave ni mogoče ugotoviti iz samega bralnega vrstnega reda, izrecno povezana s svojimi celicami glave

Primer

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

Glejte tudi

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode