BeginTagEx

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

Περιγραφή

Ανοίγει ένα στοιχείο δομής tagged-PDF στην τρέχουσα σελίδα, με ρητό χαρακτηριστικό φυσικής γλώσσας. Είναι ίδιο με το BeginTag, αλλά προσθέτει την παράμετρο Lang, η οποία γράφεται στο χαρακτηριστικό /Lang του στοιχείου δομής

Χρησιμοποιήστε αυτή τη συνάρτηση για περιεχόμενο του οποίου η γλώσσα διαφέρει από την προεπιλεγμένη γλώσσα του εγγράφου (ορισμένη από SetPDFUAMode ή SetDocumentLanguage). Το ISO 14289-1 §7.2 απαιτεί η ιδιότητα /Lang να ορίζεται σε κάθε τμήμα κειμένου που δεν είναι στην κύρια γλώσσα του εγγράφου

Τα tags πρέπει να είναι ισοζυγισμένα: κάθε κλήση BeginTagEx πρέπει να ακολουθείται από αντίστοιχη κλήση EndTag. Τα tags μπορούν να εμφωλευτούν.

Σύνταξη

Delphi

Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);

Παράμετροι

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Εναλλακτικό κείμενο για εικόνες και άλλο μη κειμενικό περιεχόμενο (attribute `/Alt`). Κενή συμβολοσειρά αν δεν χρειάζεται.
ActualText	Κείμενο αντικατάστασης για περιεχόμενο του οποίου η οπτική μορφή διαφέρει από τη λογική σημασία (attribute `/ActualText`). Κενή συμβολοσειρά αν δεν χρειάζεται.
Lang	Ετικέτα γλώσσας BCP 47 για το περιεχόμενο του στοιχείου, π.χ. `en-US`, `fr-FR`, `zh-Hans`. Κενή συμβολοσειρά για κληρονόμηση της γλώσσας του εγγράφου. Όταν δεν είναι κενή, υπερισχύει της γλώσσας επιπέδου εγγράφου για το στοιχείο και όλους τους απογόνους του.

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

0	Αποτυχία (δεν είναι ανοιχτό έγγραφο)
1	Tag opened successfully

Παράδειγμα

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;