AddTagAttribute

Tagged PDF, Akadálymentesítés

Leírás

Névvel ellátott attribútumot ad a címkekötegben éppen épülő struktúraelemhez. Az attribútum a dokumentum mentésekor PDF /A attribútumszótárként (vagy szótárak tömbjeként) íródik ki. Ezt a BeginTag vagy BeginTagEx után, és a EndTag előtt hívja

Szintaxis

Delphi

Function TPDFlib.AddTagAttribute(Const Owner, Name, Value: WideString): Integer;

ActiveX

Function PDFlib::AddTagAttribute(Owner As String, Name As String, Value As String) As Long

DLL

int DLAddTagAttribute(int InstanceID, const wchar_t * Owner, const wchar_t * Name, const wchar_t * Value);

Paraméterek

Owner	Az attribútumtulajdonos neve az ISO 32000-1 Table 348 meghatározása szerint (például `Layout`, `Table`, `List`, `PrintField`). Ez lesz az attribútumszótár `/O` kulcsa
Name	A megadott tulajdonos attribútumneve, például a Layout esetén `BBox`, a Table esetén `Scope`. Nem lehet üres
Value	Az attribútumérték karakterláncként. A csak szóközzel elválasztott számokat tartalmazó értékeket (például `"0 0 200 100"`) valós számok PDF-tömbjeként írja ki. Minden más értéket PDF-névobjektumként ír ki (kezdő `/` nélkül). Nem lehet üres

Visszatérési érték

Siker esetén 1-et ad vissza. 0-t ad vissza, ha nincs megnyitott dokumentum, nincs jelenleg nyitott címke, vagy az Owner vagy Name üres

Megjegyzések

Ugyanahhoz a nyitott címkéhez tartozó AddTagAttribute többszöri hívásai felhalmozódnak. Ha az attribútumok egyetlen tulajdonoshoz tartoznak, a könyvtár egyetlen /A attribútumszótárt ír. Több tulajdonos esetén az attribútumok tulajdonosonként csoportosulnak, és attribútumszótárak tömbjeként íródnak ki

Gyakori attribútumokhoz használhatók az SetStructElemScope és SetStructElemBBox kényelmi burkolók a AddTagAttribute közvetlen hívása helyett

Az attribútumok új címke megnyitásakor alaphelyzetbe állnak; nem öröklődnek a gyermekelemekre

Példa

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

Lásd még

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox