SetStructElemScopeA

Tagged PDF, Akadálymentesítés

Leírás

A záró A a DLL ANSI-belépési pontját (char) jelöli; az ActiveX/COM felület csak a Unicode formát teszi elérhetővé. A működés megegyezik ezzel: SetStructElemScope, és a sztringargumentumok a jelenlegi SetAnsiMode kódlap alapján értelmeződnek

A címkestack jelenleg nyitott struktúraelemén állítja be a /Scope attribútumot (Table attribútumtulajdonos). A hatókör azt azonosítja, hogy a TH (táblázatfejléc) cella oszlopra, sorra vagy mindkettőre vonatkozik-e — a PDF/UA-1 ezt fejléccellás táblázatoknál előírja. Egyenértékű az AddTagAttribute hívásával, ahol Owner=Table, Name=Scope, az érték pedig a hatókör neve

Szintaxis

Delphi

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

DLL

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

Paraméterek

Scope	A fejléc cellájának hatóköre Az alábbi értékek egyikének kell lennie, kis- és nagybetűérzékenyen: Column — a fejléc az oszlop minden cellájára érvényes Row — a fejléc a sor minden cellájára érvényes Both — a fejléc az oszlopra és a sorra is érvényes

Visszatérési érték

Siker esetén 1-et ad vissza. 0-t ad vissza, ha nincs megnyitott dokumentum, vagy nincs aktuálisan nyitott címke a címkeveremben

Megjegyzések

Ezt a függvényt a BeginTag (a TH címketípussal) után és az EndTag előtt hívja meg. A /Scope attribútumot az ISO 32000-1 §14.8.5.7.2 (táblázatattribútum-tulajdonos) határozza meg

A PDF/UA-1 (ISO 14289-1 §7.10) előírja, hogy a táblázatfejléc-cellák egyértelműen kapcsolódjanak az adatcelláikhoz. A /Scope attribútum megadása az ajánlott megoldás, ha a táblázatelrendezés ezt lehetővé teszi

Példa

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

Lásd még

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode