SetStructElemScope

Tagged PDF, Tilgængelighed

Beskrivelse

Indstiller attributten /Scope (Table-attributindehaver) på det strukturelement, der aktuelt er åbent på tagstakken. Omfanget angiver, om en TH-celle (tabeloverskrift) gælder for en kolonne, en række eller begge dele — påkrævet af PDF/UA-1 for tabeller med overskriftsceller. Svarer til at kalde AddTagAttribute med Owner=Table, Name=Scope og omfangsnavnet som værdi.

Syntaks

Delphi

Function TPDFlib.SetStructElemScope(Const Scope: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemScope(Scope As String) As Long

DLL

int DLSetStructElemScope(int InstanceID, const wchar_t * Scope);

Parametre

Scope	Headercellens område. Skal være en af følgende værdier (forskel på store og små bogstaver): Column — headeren gælder for alle celler i kolonnen Row — headeren gælder for alle celler i rækken Both — headeren gælder for både kolonnen og rækken

Returværdi

Returnerer 1 ved succes. Returnerer 0, hvis intet dokument er åbent, eller intet tag aktuelt er åbent på tagstakken

Bemærkninger

Kald denne funktion efter BeginTag (med tagtypen TH) og før EndTag. Attributten /Scope er defineret i ISO 32000-1 §14.8.5.7.2 (Table-attributindehaver).

PDF/UA-1 (ISO 14289-1 §7.10) kræver, at tabeloverskriftsceller tydeligt tilknyttes deres dataceller. Attributten /Scope er den anbefalede mekanisme, når tabellayoutet tillader det.

Eksempel

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Se også

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode