SetStructElemHeadersA

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 SetStructElemHeaders e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Imposta l'attributo /Headers (proprietario degli attributi Table) sull'elemento di struttura attualmente aperto nello stack dei tag. L'attributo associa la cella di dati o intestazione corrente della tabella a una o più celle di intestazione identificate mediante gli ID degli elementi. Viene usato per descrivere strutture di tabella complesse che non possono essere dedotte dalla sola posizione. Chiamare la funzione dopo BeginTag o BeginTagEx e prima di EndTag

Sintassi

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

Parametri

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun documento o tag è attualmente aperto

Note

Equivale a AddTagAttribute con Owner=Table, Name=Headers e lo stesso elenco ID come Value. Scrive un array /Headers nel dizionario /A dell'elemento

L'attributo /Headers è definito in ISO 32000-1 §14.8.5.7.2 (proprietario degli attributi Table). Per tabelle semplici in cui le intestazioni di colonna si trovano direttamente sopra le rispettive celle di dati, l'attributo /Scope impostato tramite SetStructElemScope è generalmente sufficiente. Usare /Headers per tabelle irregolari con celle estese o intestazioni multilivello

PDF/UA-1 (ISO 14289-1 §7.10) richiede che ogni cella TD sia associata esplicitamente alle proprie celle di intestazione nelle tabelle in cui l'associazione non può essere determinata dal solo ordine di lettura

Esempio

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Vedere anche

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode