SetStructElemScopeA

Tagged PDF, Accessibility

Beskrivelse

Den avsluttende A angir ANSI-inngangspunktet (char) i DLL-en; ActiveX/COM-flaten eksponerer kun Unicode-formen. Oppførselen er identisk med SetStructElemScope og strengargumenter tolkes ut fra gjeldende kodetabell i SetAnsiMode

Setter /Scope-attributten (Table-attributteier) på strukturelementet som står åpent på tagg-stakken. Omfanget angir om en TH-celle (tabelltopptekst) gjelder en kolonne, en rad eller begge — påkrevd av PDF/UA-1 for tabeller med topptekstceller. Tilsvarer å kalle AddTagAttribute med Owner=Table, Name=Scope og omfangsnavnet som verdi

Syntaks

Delphi

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

DLL

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

Parametere

Scope	Topptekstcellens omfang. Må være én av følgende verdier (skiller på store/små bokstaver): Column — toppteksten gjelder alle celler i kolonnen Row — toppteksten gjelder alle celler i raden Both — toppteksten gjelder både kolonnen og raden

Returverdi

Returnerer 1 ved suksess. Returnerer 0 hvis ingen dokument er åpent eller ingen tag står øverst på tag-stakken

Merknader

Kall denne funksjonen etter BeginTag (med taggtype TH) og før EndTag. Attributten /Scope er definert i ISO 32000-1 §14.8.5.7.2 (Table-attributteier)

PDF/UA-1 (ISO 14289-1 §7.10) krever at tabelltopptekstceller knyttes tydelig til sine dataceller. Å oppgi /Scope-attributten er den anbefalte mekanismen når tabellayouten tillater 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