AddTagAttribute

PDF con tag, accessibilità

Descrizione

Aggiunge un attributo denominato all'elemento nello stack. Viene scritto come dizionario /A o array. Chiamare dopo BeginTag o BeginTagEx e prima di EndTag

Sintassi

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

Parametri

Owner	Nome del proprietario dell'attributo secondo ISO 32000-1 Tabella 348, ad esempio `Layout`, `Table`, `List` o `PrintField`. Diventa la chiave `/O` del dizionario
Name	Nome dell'attributo per il proprietario specificato (ad esempio `BBox` per Layout, `Scope` per Table). Non deve essere vuoto.
Value	Valore dell'attributo come stringa. Un singolo numero viene scritto come numero PDF e i valori che contengono solo numeri separati da spazi (ad esempio `"0 0 200 100"`) vengono scritti come array PDF di reali. I numeri usano il punto come separatore decimale su ogni sistema; un numero scritto con il separatore decimale del sistema viene comunque accettato. Qualsiasi altro valore viene scritto come nome PDF (senza `/` iniziale). Non può essere vuoto

Valore restituito

Restituisce 1 in caso di successo. Restituisce 0 se nessun documento è aperto, nessun tag è attualmente aperto oppure Owner o Name è vuoto.

Note

Più chiamate AddTagAttribute sullo stesso tag si accumulano. Un proprietario produce un solo dizionario /A; più proprietari producono un array di dizionari raggruppati

Per gli attributi comuni è possibile usare SetStructElemScope e SetStructElemBBox anziché chiamare direttamente AddTagAttribute

Gli attributi vengono reimpostati all'apertura di un nuovo tag e non sono ereditati dagli elementi figli

Esempio

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

Vedere anche

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox