SetStructElemRowSpan

Tagged PDF, Accessibility

Description

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

Syntax

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parameters

RowSpan	Il numero di righe 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 riga (comportamento predefinito quando non è impostato RowSpan); valori superiori a 1 indicano una cella che si estende su più righe

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 /RowSpan è definito in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Table 337)

Row-spanning cells appear in tables where a header or data cell needs to stretch vertically across multiple rows — for example, a row header shared by several data rows. Providing the /RowSpan attribute lets assistive technology correctly build the logical grid model of the table

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

Example

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;