SetStructElemScopeA

Tagged PDF, Accessibility

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 SetStructElemScope en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Zet het attribuut /Scope (Table-attribuuteigenaar) op het structuurelement dat momenteel open staat op de tagstack. De scope geeft aan of een TH-(tabelheader-)cel op een kolom, een rij of beide van toepassing is — vereist door PDF/UA-1 voor tabellen met headercellen. Gelijk aan het aanroepen van AddTagAttribute met Owner=Table, Name=Scope en de scopenaam als waarde

Syntaxis

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

Parameters

Scope	Het bereik van de kopcel. Moet een van de volgende waarden zijn (hoofdlettergevoelig): Column — de kop is van toepassing op alle cellen in de kolom Row — de kop is van toepassing op alle cellen in de rij Both — de kop is van toepassing op zowel de kolom als de rij

Retourwaarde

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

Remarks

Roep deze functie aan na BeginTag (met tagtype TH) en vóór EndTag. Het attribuut /Scope is gedefinieerd in ISO 32000-1 §14.8.5.7.2 (Table-attribuuteigenaar)

PDF/UA-1 (ISO 14289-1 §7.10) eist dat tabelheadercellen duidelijk aan hun datacellen gekoppeld zijn. Het /Scope-attribuut opgeven is het aanbevolen mechanisme wanneer de tabellayout dat toelaat

Voorbeeld

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

Zie ook

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode