SetStructElemRowSpan

Tagovaný PDF, prístupnosť

Opis

Nastaví atribút /RowSpan (vlastník atribútov Table) na štruktúrnom prvku aktuálne otvorenom na zásobníku tagov. Hodnota určuje, koľko riadkov aktuálna bunka tabuľky prekrýva. Ekvivalent volania AddTagAttribute s Owner=Table, Name=RowSpan a celočíselnou hodnotou ako reťazcom.

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parametre

RowSpan	Počet riadkov, ktoré aktuálna bunka tabuľky prekrýva. Musí to byť kladné celé číslo. Hodnota 1 znamená, že bunka zaberá presne jeden riadok (predvolené správanie, keď nie je nastavený RowSpan). Hodnoty väčšie než 1 označujú bunku prekrývajúcu viac riadkov.

Návratová hodnota

Vráti 1 pri úspechu. Vráti 0, ak nie je otvorený žiadny dokument alebo sa na zásobníku tagov práve neotvára žiadny tag

Poznámky

Túto funkciu zavolajte po BeginTag (s typom tagu TH alebo TD) a pred EndTag. Atribút /RowSpan je definovaný v ISO 32000-1 §14.8.5.7.2 (Table attribute owner, tabuľka 337).

Vertikálne spájané bunky sa objavujú v tabuľkách, kde hlavičková alebo údajová bunka potrebuje zvisle prekryť viacero riadkov — napríklad hlavička riadku zdieľaná viacerými údajovými riadkami. Poskytnutie atribútu /RowSpan umožní asistívnym technológiám správne zostaviť logický model mriežky tabuľky.

Keď bunka prekrýva aj viac stĺpcov, použite SetStructElemColSpan v kombinácii s touto funkciou.

Príklad

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

Pozri tiež

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag