BeginTagEx2

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

Περιγραφή

Ανοίγει νέο στοιχείο δομής και το σπρώχνει στη στοίβα tags, ορίζοντας όλες τις κύριες ιδιότητες σε μία κλήση. Το BeginTagEx2 είναι wrapper ευκολίας του BeginTagEx ακολουθούμενο από SetStructElemTitle, SetStructElemID και SetStructElemExpansion. Κενή συμβολοσειρά σε οποιοδήποτε από Title, ElemID, Expansion παραλείπει τον αντίστοιχο setter· τα άλλα ορίσματα συμπεριφέρονται όπως στο BeginTagEx.

Χρησιμοποιήστε BeginTagEx2 όταν γνωρίζετε ήδη όλες τις περιγραφικές ιδιότητες του στοιχείου τη στιγμή του ανοίγματος, για να αποφύγετε πολλές συνεχόμενες κλήσεις setters. Αν κάποια ιδιότητα προκύπτει αργότερα (π.χ. το AltText φτάνει ασύγχρονα), χρησιμοποιήστε BeginTag ή BeginTagEx και καλέστε τους setters ξεχωριστά μετά.

Σύνταξη

Delphi

Function TPDFlib.BeginTagEx2(Const TagType, AltText, ActualText, Lang, Title, ElemID, Expansion: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx2(TagType As String, AltText As String, ActualText As String, Lang As String, Title As String, ElemID As String, Expansion As String) As Long

DLL

int DLBeginTagEx2(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang, const wchar_t * Title, const wchar_t * ElemID, const wchar_t * Expansion);

Παράμετροι

TagType	Το όνομα τύπου στοιχείου δομής, π.χ. `Figure`, `Table`, `Span`, `P`. Οι ίδιοι τύποι που δέχεται το BeginTag.
AltText	Εναλλακτικό κείμενο που γράφεται στην εγγραφή /Alt (ISO 32000-1 §14.9.3). Δώστε κενή συμβολοσειρά για παράλειψη
ActualText	Το πραγματικό κείμενο που γράφεται στην εγγραφή /ActualText (ISO 32000-1 §14.9.4). Δώστε κενή συμβολοσειρά για παράλειψη
Lang	Ετικέτα γλώσσας BCP 47 που γράφεται στην καταχώρηση /Lang (ISO 32000-1 §14.9.2), π.χ. `en-US`, `fr`, `zh-Hant-TW`. Περάστε κενή συμβολοσειρά για να κληρονομηθεί η γλώσσα του εγγράφου
Title	Αναγνώσιμη ετικέτα που γράφεται στην εγγραφή /T (ISO 32000-1 §14.7.2). Εμφανίζεται στο πάνελ πλοήγησης Tags. Δώστε κενή συμβολοσειρά για παράλειψη
ElemID	Μοναδικό αναγνωριστικό στοιχείου που γράφεται στην εγγραφή /ID (ISO 32000-1 §14.7.4). Πρέπει να είναι μοναδικό στο έγγραφο αν οριστεί. Δώστε κενή συμβολοσειρά για παράλειψη
Expansion	Ανάπτυξη συντομογραφίας ή ακρωνυμίου που γράφεται στην εγγραφή /E (ISO 32000-1 §14.9.5). Περάστε κενή συμβολοσειρά για παράλειψη

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

Επιστρέφει 1 σε επιτυχία, 0 αν δεν έχει επιλεγεί έγγραφο

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

Καλέστε το EndTag μία φορά για κάθε επιτυχή κλήση BeginTagEx2, ώστε να αφαιρέσετε το στοιχείο από τη στοίβα ετικετών. Τα στοιχεία δομής μπορούν να είναι ένθετα: η κλήση της BeginTagEx2 ενώ ένα άλλο στοιχείο είναι ανοιχτό δημιουργεί θυγατρικό στοιχείο

Η εσωτερική υλοποίηση είναι ακριβώς ισοδύναμη με:

BeginTagEx(TagType, AltText, ActualText, Lang);
if Title <> '' then SetStructElemTitle(Title);
if ElemID <> '' then SetStructElemID(ElemID);
if Expansion <> '' then SetStructElemExpansion(Expansion);

Οι μεμονωμένοι setters παραμένουν διαθέσιμοι για ιδιότητες που προκύπτουν μετά το άνοιγμα του στοιχείου, ή για ιδιότητες που δεν καλύπτει το BeginTagEx2 (όπως το AddTagAttribute για attribute κελιών πίνακα).

Παράδειγμα

// Tag a figure with all descriptive properties in one call
PDFlib.BeginTagEx2(
  'Figure',                              // TagType
  'Bar chart: Q1 120, Q2 145, Q3 98',   // AltText
  '',                                    // ActualText (not needed for images)
  '',                                    // Lang (inherit document language)
  'Figure 3: Quarterly Sales',           // Title
  'fig-quarterly-sales',                 // ElemID
  ''                                     // Expansion (not an abbreviation)
);
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

// Tag an acronym span with its expansion
PDFlib.BeginTagEx2(
  'Span',
  '',                                          // AltText
  '',                                          // ActualText
  '',                                          // Lang
  '',                                          // Title
  '',                                          // ElemID
  'World Wide Web Consortium'                  // Expansion
);
PDFlib.WriteText('W3C');
PDFlib.EndTag;

Δείτε επίσης

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion