AddTagAttribute

Tagged PDF, Accessibility

Beskrivelse

Legger et navngitt attributt til strukturelementet som bygges på tag-stakken akkurat nå. Attributtet skrives som en PDF /A-attributtordbok (eller matrise av ordbøker) når dokumentet lagres. Kall denne etter BeginTag eller BeginTagEx og før EndTag

Syntaks

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

Parametere

Owner	Attributt-eiernavnet som definert i ISO 32000-1 Table 348 (f.eks. `Layout`, `Table`, `List`, `PrintField`). Dette blir `/O`-nøkkelen i attributtordboken
Name	Attributtnavnet for den gitte eieren (f.eks. `BBox` for Layout, `Scope` for Table). Må ikke være tomt
Value	Attributtverdien som en streng. Verdier som bare inneholder mellomrom-atskilte tall (f.eks. `"0 0 200 100"`) skrives som en PDF-matrise av reelle tall. Enhver annen verdi skrives som et PDF-navnobjekt (uten innledende `/`). Må ikke være tom

Returverdi

Returnerer 1 ved suksess. Returnerer 0 hvis ingen dokument er åpent, ingen tag står åpent, eller Owner eller Name er tom

Merknader

Flere kall til AddTagAttribute for samme åpne tag akkumuleres. Når attributtene tilhører én eier, skriver biblioteket én enkelt /A-attributtordbok. Når flere eiere brukes, grupperes attributtene per eier og skrives som en matrise av attributtordbøker

For vanlige attributter kan bekvemmelighets-wrapperne SetStructElemScope og SetStructElemBBox brukes i stedet for å kalle AddTagAttribute direkte

Attributter nullstilles når en ny tag åpnes; de arves ikke av underelementer

Eksempel

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

Se også

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox