SetStructElemAltTextA

Tagged PDF & Accessibility

Περιγραφή

Το καταληκτικό A υποδηλώνει το σημείο εισόδου ANSI (char) του DLL· η διεπαφή ActiveX/COM εκθέτει μόνο τη μορφή Unicode. Η συμπεριφορά είναι ταυτόσημη με το SetStructElemAltText και τα ορίσματα συμβολοσειράς ερμηνεύονται χρησιμοποιώντας την τρέχουσα σελίδα κωδίκων του SetAnsiMode

Ορίζει την εγγραφή /Alt στο στοιχείο δομής που κατασκευάζεται αυτή τη στιγμή στη στοίβα ετικετών. Το εναλλακτικό κείμενο είναι η περιγραφή που παρουσιάζουν στους χρήστες οι assistive technologies (screen readers, braille displays) όταν το στοιχείο δεν μπορεί να αποδοθεί οπτικά — για παράδειγμα μια εικόνα, σχήμα ή μαθηματικό formula

This function is equivalent to passing a non-empty AltText argument to BeginTag or BeginTagEx, but allows the alternative text to be set or updated after the element has been opened. It is useful when the description is computed or retrieved asynchronously after the element type is known.

Syntax

Delphi

Function DLSetStructElemAltTextA(InstanceID: Integer; AltText: PAnsiChar): Integer;

DLL

int DLSetStructElemAltTextA(int InstanceID, const char * AltText);

Parameters

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

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

Remarks

Call this function immediately after BeginTag while the target element is at the top of the tag stack, or at any point before the matching EndTag call.

Τα AltText και ActualText εξυπηρετούν διαφορετικούς σκοπούς. Το AltText είναι πλήρης κειμενική υποκατάσταση για ολόκληρο το στοιχείο — αντικαθιστά το οπτικό περιεχόμενο για χρήστες που δεν μπορούν να αντιληφθούν την αποδιδόμενη έξοδο. Το ActualText (ISO 32000-1 §14.9.4) παρέχει την ακριβή ακολουθία χαρακτήρων Unicode για inline glyphs των οποίων το εξαγόμενο κείμενο θα ήταν διαφορετικά εσφαλμένο, όπως οι ligatures, και δεν αντικαθιστά την απόδοση. Τα προγράμματα ανάγνωσης οθόνης συνήθως εκφωνούν το AltText για στοιχεία Figure και Formula και χρησιμοποιούν το ActualText για διορθώσεις σε επίπεδο χαρακτήρα

ISO 32000-1 §14.9.3 defines the /Alt entry. PDF/UA-1 (ISO 14289-1 §7.5) requires alternative descriptions on Figure and Formula structure elements. GetPDFUADiagnostics reports the FIGURE-NO-ALT:N issue code when Figure or Formula elements are missing Alt text.

Παράδειγμα

// Tag an embedded chart image with alternative text
PDFlib.BeginTag('Figure', '', '');
PDFlib.SetStructElemAltText('Bar chart: Q1 sales 120, Q2 sales 145, Q3 sales 98');
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

Δείτε επίσης

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics