AddTagAttributeA

PDF con tag, accessibilità

Descrizione

Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a AddTagAttribute e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

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 DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;

DLL

int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * 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. Valori di soli numeri separati da spazi, ad esempio `"0 0 200 100"`, diventano array PDF di reali; gli altri diventano nomi PDF senza `/`. 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