BeginTag

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

Περιγραφή

Ανοίγει ένα στοιχείο δομής tagged-PDF στην τρέχουσα σελίδα. Γράφει έναν τελεστή BDC (Begin Marked Content with Dictionary) στο content stream και καταχωρίζει το στοιχείο στο λογικό δέντρο δομής του εγγράφου. Το δέντρο δομής οριστικοποιείται αυτόματα κατά την αποθήκευση του εγγράφου

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

Σύνταξη

Delphi

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

ActiveX

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

DLL

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

Παράμετροι

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` του PDF). Κενή συμβολοσειρά αν δεν χρειάζεται.
ActualText	Κείμενο αντικατάστασης για περιεχόμενο του οποίου η οπτική αναπαράσταση διαφέρει από το λογικό του νόημα (αντιστοιχεί στο χαρακτηριστικό PDF `/ActualText`). Δώστε κενή συμβολοσειρά αν δεν απαιτείται

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

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

Παράδειγμα

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

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

Χρησιμοποιήστε BeginArtifact/EndArtifact για διακοσμητικό περιεχόμενο (headers, footers, στοιχεία φόντου) που δεν πρέπει να διαβάζουν οι screen readers.

Το έγγραφο πρέπει να βρίσκεται σε write mode (να έχει δημιουργηθεί ή ανοιχτεί για τροποποίηση). Καλέστε το SetPDFUAMode πριν από την προσθήκη ετικετών για να ικανοποιήσετε τις απαιτήσεις του PDF/UA-1

Η σήμανση εγγράφου με tags το μαρκάρει ως tagged κατά την αποθήκευση, πράγμα που χρειάζεται ο reader για να θεωρήσει καθόλου παρούσα τη δομή. Ρύθμιση SetMarkInfo από τον καλών μένει ως έχει.