SetStructElemRowSpan

Tagged PDF, saavutettavuus

Kuvaus

Asettaa /RowSpan-attribuutin (Table-attribuuttiomistaja) tagipinossa avoinna olevalle rakennetyylielementille. Arvo kertoo, montaa riviä nykyinen taulukkosolu kattaa. Vastaa AddTagAttributein kutsumista arvoilla Owner=Table, Name=RowSpan ja kokonaislukuarvolla merkkijonona

Syntaksi

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parametrit

RowSpan	Rivimäärä, jonka nykyinen taulukkosolu kattaa. On oltava positiivinen kokonaisluku. Arvo 1 tarkoittaa, että solu kattaa täsmälleen yhden rivin (oletuskäyttäytyminen, kun RowSpania ei ole asetettu). Arvot suurempia kuin 1 tarkoittavat useaa riviä kattavaa solua

Paluuarvo

Palauttaa arvon 1 onnistuessaan ja arvon 0, jos asiakirjaa ei ole avattu tai tagipinossa ei ole avointa tagia

Huomautukset

Kutsu tätä funktiota BeginTagin (tagityypillä TH tai TD) jälkeen ja ennen EndTagia. /RowSpan-attribuutti on määritelty standardissa ISO 32000-1 §14.8.5.7.2 (Table-attribuuttiomistaja, Table 337)

Rivejä kattavat solut esiintyvät taulukoissa, joissa otsikko- tai datasolun pitää venyä pystysuunnassa usean rivin yli — esimerkiksi rivinotsikko, jota useat datarivit jakavat. /RowSpan-attribuutin toimittaminen antaa avustavalle teknologialle mahdollisuuden rakentaa taulukon looginen ruudukkomalli oikein

Jos solu ulottuu myös usean sarakkeen yli, käytä funktiota SetStructElemColSpan yhdessä tämän funktion kanssa.

Esimerkki

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

Katso myös

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag