SetStructElemActualText

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

Περιγραφή

Ορίζει την καταχώριση /ActualText στο στοιχείο δομής που δημιουργείται αυτή τη στιγμή στη στοίβα ετικετών. Το ActualText παρέχει το ακριβές κείμενο Unicode που αναπαριστά το στοιχείο, παρακάμπτοντας οποιοδήποτε κείμενο εξάγεται από το content stream του PDF από λογισμικό ανάγνωσης

Χρησιμοποιήστε αυτή τη συνάρτηση όταν οι γλυφές που αποδίδονται στη ροή περιεχομένου δεν αντιστοιχούν άμεσα στους προβλεπόμενους χαρακτήρες σειράς ανάγνωσης — για παράδειγμα, μια γλυφή δεσμού (ff, fi, fl) που πρέπει να διαβάζεται ως ακολουθία δύο χαρακτήρων ff, fi ή fl. Χωρίς ActualText, τα εργαλεία εξαγωγής κειμένου και οι αναγνώστες οθόνης μπορεί να παράγουν εσφαλμένη έξοδο για τέτοιες γλυφές.

Σύνταξη

Delphi

Function TPDFlib.SetStructElemActualText(Const ActualText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemActualText(ActualText As String) As Long

DLL

int DLSetStructElemActualText(int InstanceID, const wchar_t * ActualText);

Παράμετροι

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

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

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

Καλέστε αυτή τη συνάρτηση αμέσως μετά τα BeginTag ή BeginTagEx, όσο το στοιχείο-στόχος βρίσκεται στην κορυφή της στοίβας ετικετών

Το ActualText και το AltText έχουν διαφορετικούς σκοπούς. Το AltText (μέσω της παραμέτρου AltText του BeginTag) είναι εναλλακτική αναπαράσταση ολόκληρου του στοιχείου για υποστηρικτικές τεχνολογίες όταν το οπτικό περιεχόμενο δεν μπορεί να αποδοθεί. Το ActualText συμπληρώνει την εξαγωγή κειμένου από content stream: αντικαθιστά την εξαγόμενη αλληλουχία χαρακτήρων του στοιχείου αλλά δεν καταστέλλει την απόδοση. Screen readers που υποστηρίζουν και τα δύο τυπικά χρησιμοποιούν το ActualText για εκφωνούμενο output όταν υπάρχει.

Το ISO 32000-1 §14.9.4 ορίζει το ActualText ως συμβολοσειρά κειμένου PDF στην καταχώριση λεξικού του στοιχείου δομής. Το PDF/UA-1 (ISO 14289-1 §7.1) απαιτεί το περιεχόμενο κειμένου να είναι εξαγώγιμο και σωστό· το ActualText είναι ο τυπικός μηχανισμός για την ικανοποίηση αυτής της απαίτησης σε ακολουθίες glyph των οποίων η άμεση εξαγωγή θα ήταν αμφίσημη ή εσφαλμένη

Παράδειγμα

// Tag a ligature glyph so that text extraction yields "fi"
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemActualText('fi');
PDFlib.TextOut(x, y, #$FB01);   // U+FB01 LATIN SMALL LIGATURE FI
PDFlib.EndTag;

Δείτε επίσης

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics