SetStructElemRowSpan

PDF με ετικέτες, Προσβασιμότητα

Περιγραφή

Θέτει το attribute /RowSpan (ιδιοκτήτης Table) στο στοιχείο δομής που είναι ανοικτό στη στοίβα tags. Η τιμή δείχνει πόσες γραμμές εκτείνεται το τρέχον κελί πίνακα. Ισοδυναμεί με κλήση AddTagAttribute με Owner=Table, Name=RowSpan και την ακέραια τιμή ως συμβολοσειρά.

Σύνταξη

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Παράμετροι

RowSpanΟ αριθμός γραμμών που καλύπτει το τρέχον κελί πίνακα. Πρέπει να είναι θετικός ακέραιος. Τιμή 1 σημαίνει ότι το κελί καταλαμβάνει ακριβώς μία γραμμή (προεπιλεγμένη συμπεριφορά όταν δεν ορίζεται RowSpan). Τιμές μεγαλύτερες από 1 δείχνουν κελί που εκτείνεται σε πολλές γραμμές

Τιμή επιστροφής

Επιστρέφει 1 σε περίπτωση επιτυχίας. Επιστρέφει 0 αν δεν έχει ανοίξει έγγραφο ή αν δεν υπάρχει ανοικτή ετικέτα στη στοίβα ετικετών

Παρατηρήσεις

Καλέστε αυτή τη συνάρτηση μετά το BeginTag (με τύπο ετικέτας TH ή TD) και πριν από το EndTag. Το γνώρισμα /RowSpan ορίζεται στο ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Table 337)

Κελιά που εκτείνονται σε γραμμές εμφανίζονται σε πίνακες όπου ένα κελί επικεφαλίδας ή δεδομένων χρειάζεται να απλωθεί κατακόρυφα σε πολλές γραμμές — για παράδειγμα, μια επικεφαλίδα γραμμής που μοιράζονται πολλές γραμμές δεδομένων. Η παροχή της ιδιότητας /RowSpan επιτρέπει στην υποβοηθούμενη τεχνολογία να χτίσει σωστά το λογικό μοντέλο πλέγματος του πίνακα

Όταν κελί εκτείνεται και σε πολλές στήλες, χρησιμοποιήστε SetStructElemColSpan σε συνδυασμό με αυτή τη συνάρτηση.

Παράδειγμα

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

Δείτε επίσης

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag