SetStructElemColSpan

Tagged PDF, Accessibility

Description

Imposta l'attributo /ColSpan (proprietario dell'attributo Table) sull'elemento di struttura attualmente aperto sullo stack dei tag; il valore indica quante colonne occupa la cella corrente della tabella; equivalente a chiamare AddTagAttribute con Owner=Table, Name=ColSpan e il valore intero come stringa

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parameters

ColSpan	Il numero di colonne che si estendono sulla cella corrente della tabella; deve essere un intero positivo; un valore pari a 1 indica che la cella occupa esattamente una colonna (comportamento predefinito quando non è impostato ColSpan); valori superiori a 1 indicano una cella di intestazione o di dati con estensione

Return value

Restituisce 1 in caso di successo; restituisce 0 se nessun documento è aperto o se nessun tag è attualmente aperto sullo stack dei tag

Remarks

Chiamare questa funzione dopo BeginTag (con tipo tag TH o TD) e prima di EndTag; l'attributo /ColSpan è definito in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Table 337)

Le celle con spanning sono comuni nelle tabelle complesse — ad esempio, un'intestazione di colonna che si estende su due colonne di dati; fornire l'attributo /ColSpan consente alla tecnologia assistiva di calcolare correttamente le posizioni delle celle e associare le intestazioni alle celle di dati nell'intera griglia della tabella

Quando una cella si estende anche su più righe, usare SetStructElemRowSpan in combinazione con questa funzione

Example

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