SetStructElemHeaders

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

Περιγραφή

Θέτει το attribute /Headers (ιδιοκτήτης Table) στο στοιχείο δομής που είναι ανοικτό στη στοίβα tags. Το attribute συνδέει το τρέχον κελί δεδομένων ή επικεφαλίδας πίνακα με ένα ή περισσότερα κελιά επικεφαλίδας ταυτοποιημένα από τα element IDs τους. Χρησιμοποιείται για περιγραφή πολύπλοκων δομών πινάκων που δεν συμπεραίνονται από τη θέση μόνο. Καλέστε το μετά από BeginTag ή BeginTagEx και πριν το EndTag.

Σύνταξη

Delphi

Function TPDFlib.SetStructElemHeaders(Const Headers: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemHeaders(Headers As String) As Long

DLL

int DLSetStructElemHeaders(int InstanceID, const wchar_t * Headers);

Παράμετροι

Headers Λίστα element IDs των κελιών TH που είναι επικεφαλίδες στήλης ή γραμμής για το τρέχον κελί TD ή TH, διαχωρισμένα με κόμμα. Κάθε ID πρέπει να ταιριάζει με ElemID που ανατέθηκε σε στοιχείο TH μέσω SetStructElemID νωρίτερα στο ίδιο έγγραφο. Κενά γύρω από κόμματα αγνοούνται. Παράδειγμα: TH-ProductName,TH-Price.

Headers	Λίστα element IDs των κελιών TH που είναι επικεφαλίδες στήλης ή γραμμής για το τρέχον κελί TD ή TH, διαχωρισμένα με κόμμα. Κάθε ID πρέπει να ταιριάζει με ElemID που ανατέθηκε σε στοιχείο TH μέσω SetStructElemID νωρίτερα στο ίδιο έγγραφο. Κενά γύρω από κόμματα αγνοούνται. Παράδειγμα: `TH-ProductName,TH-Price`.

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

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

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

Η συνάρτηση ισοδυναμεί με κλήση AddTagAttribute με Owner=Table, Name=Headers και την ίδια λίστα ID διαχωρισμένων με κόμμα ως Value. Το attribute γράφεται ως πίνακας /Headers από PDF συμβολοσειρές κειμένου στο λεξικό attribute /A του στοιχείου δομής.

Η ιδιότητα /Headers ορίζεται στο ISO 32000-1 §14.8.5.7.2 (ιδιοκτήτης ιδιοτήτων Table). Για απλούς πίνακες όπου οι επικεφαλίδες στηλών βρίσκονται απευθείας πάνω από τα κελιά δεδομένων τους, η ιδιότητα /Scope που ορίζεται μέσω SetStructElemScope είναι γενικά επαρκής. Χρησιμοποιήστε /Headers για ακανόνιστους πίνακες με κελιά που εκτείνονται ή επικεφαλίδες πολλαπλών επιπέδων

Το PDF/UA-1 (ISO 14289-1 §7.10) απαιτεί κάθε κελί TD να συνδέεται ρητά με τα κελιά επικεφαλίδας του σε πίνακες όπου η σύνδεση δεν μπορεί να εξαχθεί μόνο από τη σειρά ανάγνωσης

Παράδειγμα

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Δείτε επίσης

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode