SetStructElemScopeA

Tagged PDF, Accessibility

Description

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

Sätter attributet /Scope (Table-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Omfattningen anger huruvida en TH-cell (tabellrubrik) gäller en kolumn, en rad eller båda — krävt av PDF/UA-1 för tabeller med rubrikceller. Ekvivalent med att anropa AddTagAttribute med Owner=Table, Name=Scope och omfångsnamnet som värde

Syntax

Delphi

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

DLL

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

Parameters

Scope	Rubrikcellens omfattning. Måste vara ett av följande värden (skiftlägeskänsligt): Column — rubriken gäller alla celler i kolumnen Row — rubriken gäller alla celler i raden Both — rubriken gäller både kolumnen och raden

Return value

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

Remarks

Anropa den här funktionen efter BeginTag (med taggtyp TH) och före EndTag. Attributet /Scope är definierat i ISO 32000-1 §14.8.5.7.2 (Table-attributägare)

PDF/UA-1 (ISO 14289-1 §7.10) kräver att tabellrubrikceller tydligt kopplas till sina dataceller. Att tillhandahålla attributet /Scope är den rekommenderade mekanismen när tabellayouten tillåter det

Example

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