SetStructElemLang

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

Περιγραφή

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

Σύνταξη

Delphi

Function TPDFlib.SetStructElemLang(Const Lang: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemLang(Lang As String) As Long

DLL

int DLSetStructElemLang(int InstanceID, const wchar_t * Lang);

Παράμετροι

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

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

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

Καλέστε τη συνάρτηση αμέσως μετά από BeginTag ή BeginTagEx όσο το στοιχείο-στόχος είναι στην κορυφή της στοίβας tags. Ισοδυναμεί με πέρασμα μη κενού ορίσματος Lang στο BeginTagEx, αλλά μπορεί να είναι βολικότερο όταν η γλώσσα αποφασίζεται χωριστά από τον τύπο του στοιχείου.

Η εγγραφή /Lang σε επίπεδο στοιχείου ορίζεται στο ISO 32000-1 §14.9.2. Εφαρμόζεται στο στοιχείο δομής και, μέσω κληρονομικότητας, σε όλα τα θυγατρικά στοιχεία που δεν δηλώνουν τα ίδια /Lang. Τα screen readers χρησιμοποιούν αυτή την εγγραφή για να επιλέξουν την κατάλληλη φωνή text-to-speech ή μηχανή γλώσσας κατά την εκφώνηση του εγγράφου

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

Παράδειγμα

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

Δείτε επίσης

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics