SetStructElemRowSpan

Tagged PDF, Pristupačnost

Opis

Postavlja /RowSpan atribut (vlasnik Table atributa) na element strukture trenutno otvoren na steku tagova. Vrednost pokazuje koliko redova trenutna ćelija tabele premošćuje. Ekvivalentno pozivu AddTagAttribute sa Owner=Table, Name=RowSpan i celobrojnom vrednošću kao string

Sintaksa

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parametri

RowSpan	Broj redova koje trenutna ćelija tabele obuhvata. Mora biti pozitivan ceo broj. Vrednost 1 znači da ćelija zauzima tačno jedan red (podrazumevano ponašanje kad RowSpan nije postavljen). Vrednosti veće od 1 označavaju ćeliju koja se proteže kroz više redova

Povratna vrednost

Vraća 1 u slučaju uspeha. Vraća 0 ako nijedan dokument nije otvoren ili ako nijedan tag nije trenutno otvoren na steku tagova

Napomene

Pozovite ovu funkciju nakon BeginTag (sa tipom oznake TH ili TD) i pre EndTag. Atribut /RowSpan definisan je u ISO 32000-1 §14.8.5.7.2 (vlasnik atributa Table, Tabela 337).

Ćelije koje se protežu kroz više redova javljaju se u tabelama gde zaglavlje ili ćelija podataka treba da se raširi vertikalno kroz više redova — na primer, redno zaglavlje deljeno sa nekoliko redova podataka. Navođenje atributa /RowSpan omogućava asistivnoj tehnologiji da pravilno izgradi logički model mreže tabele.

Kad ćelija obuhvata i više kolona, koristite SetStructElemColSpan u kombinaciji sa ovom funkcijom

Primer

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

Vidi takođe

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag