SetStructElemRowSpan

PDF etichetat, Accesibilitate

Descriere

Setează atributul /RowSpan (deținător de atribute Table) pe elementul de structură deschis curent pe stiva de taguri. Valoarea indică peste câte rânduri se întinde celula de tabel curentă. Echivalent cu apelarea AddTagAttribute cu Owner=Table, Name=RowSpan și valoarea întreagă ca șir

Sintaxă

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	Numărul de rânduri pe care le ocupă celula curentă de tabel. Trebuie să fie un întreg pozitiv. Valoarea 1 înseamnă că celula ocupă exact un rând (comportamentul implicit când nu este setat RowSpan). Valorile mai mari de 1 indică o celulă care se întinde pe mai multe rânduri

Valoare returnată

Returnează 1 în caz de succes. Returnează 0 dacă niciun document nu este deschis sau dacă nu există niciun tag deschis în stiva de tag-uri

Observații

Apelați această funcție după BeginTag (cu tip de tag TH sau TD) și înainte de EndTag. Atributul /RowSpan este definit în ISO 32000-1 §14.8.5.7.2 (deținător de atribute Table, Table 337)

Celulele care se întind pe mai multe rânduri apar în tabelele unde o celulă de antet sau de date trebuie să se întindă vertical peste mai multe rânduri — de exemplu, un antet de rând partajat de mai multe rânduri de date. Furnizarea atributului /RowSpan permite tehnologiei asistive să construiască corect modelul logic de grilă al tabelului

Când o celulă se întinde și pe mai multe coloane, folosiți SetStructElemColSpan în combinație cu această funcție

Exemplu

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

Consultați și

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag