SetStructElemColSpan

PDF con tag, accessibilità

Descrizione

Imposta l'attributo /ColSpan (proprietario Table) sull'elemento aperto nello stack dei tag. Il valore indica quante colonne occupa la cella. Equivale a AddTagAttribute con Owner=Table, Name=ColSpan e il valore intero come stringa

Sintassi

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parametri

ColSpan	Numero di colonne occupate dalla cella corrente della tabella. Deve essere un intero positivo. Il valore 1 indica che la cella occupa esattamente una colonna, comportamento predefinito quando ColSpan non è impostato. I valori maggiori di 1 indicano una cella di intestazione o dati estesa su più colonne

Valore restituito

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

Note

Chiamare dopo BeginTag con tag TH o TD e prima di EndTag. /ColSpan è definito in ISO 32000-1 §14.8.5.7.2 (proprietario Table, Tabella 337)

Le celle estese sono comuni nelle tabelle complesse, ad esempio un'intestazione di colonna che si estende su due colonne di dati. L'attributo /ColSpan consente alle tecnologie assistive di calcolare correttamente le posizioni delle celle e associare le intestazioni alle celle dati nell'intera griglia della tabella

Quando una cella si estende anche su più righe, usare SetStructElemRowSpan insieme a questa funzione.

Esempio

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Vedere anche

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag