SetStructElemWritingMode

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

Περιγραφή

Θέτει το attribute /WritingMode (ιδιοκτήτης Layout) στο στοιχείο δομής που είναι ανοικτό στη στοίβα tags. Η λειτουργία γραφής δηλώνει την κύρια κατεύθυνση γραφής κειμένου μέσα στο στοιχείο και επηρεάζει πώς οι υποστηρικτικές τεχνολογίες ερμηνεύουν τη σειρά ανάγνωσης. Ισοδυναμεί με κλήση AddTagAttribute με Owner=Layout, Name=WritingMode και το όνομα λειτουργίας ως τιμή.

Σύνταξη

Delphi

Function TPDFlib.SetStructElemWritingMode(Const WritingMode: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemWritingMode(WritingMode As String) As Long

DLL

int DLSetStructElemWritingMode(int InstanceID, const wchar_t * WritingMode);

Παράμετροι

WritingMode	Η κατεύθυνση γραφής για το στοιχείο. Πρέπει να είναι μία από τις εξής τιμές (με διάκριση πεζών-κεφαλαίων): LrTb — από αριστερά προς τα δεξιά, από πάνω προς τα κάτω (προεπιλογή· λατινικά, κυριλλικά, ελληνικά και οι περισσότερες γραφές) RlTb — από δεξιά προς τα αριστερά, από πάνω προς τα κάτω (αραβικά, εβραϊκά) TbRl — από πάνω προς τα κάτω, από δεξιά προς τα αριστερά (παραδοσιακό κατακόρυφο κείμενο CJK)

WritingMode

Η κατεύθυνση γραφής για το στοιχείο. Πρέπει να είναι μία από τις εξής τιμές (με διάκριση πεζών-κεφαλαίων):

LrTb — από αριστερά προς τα δεξιά, από πάνω προς τα κάτω (προεπιλογή· λατινικά, κυριλλικά, ελληνικά και οι περισσότερες γραφές)
RlTb — από δεξιά προς τα αριστερά, από πάνω προς τα κάτω (αραβικά, εβραϊκά)
TbRl — από πάνω προς τα κάτω, από δεξιά προς τα αριστερά (παραδοσιακό κατακόρυφο κείμενο CJK)

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

Επιστρέφει 1 σε περίπτωση επιτυχίας. Επιστρέφει 0 αν δεν έχει ανοίξει έγγραφο ή αν δεν υπάρχει ανοικτή ετικέτα στη στοίβα ετικετών

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

Καλέστε αυτή τη συνάρτηση μετά το BeginTag ή BeginTagEx και πριν το EndTag. Η ιδιότητα /WritingMode ορίζεται στο ISO 32000-1 §14.8.5.4.2 (ιδιοκτήτης ιδιοτήτων Layout, Table 340)

Όταν ένα έγγραφο χρησιμοποιεί σταθερή κατεύθυνση γραφής σε όλη του την έκταση, δεν χρειάζεται να ορίζετε το /WritingMode σε κάθε στοιχείο — εφαρμόζεται η προεπιλογή LrTb όταν το χαρακτηριστικό απουσιάζει. Ορίστε το χαρακτηριστικό ρητά σε στοιχεία επιπέδου block των οποίων η κατεύθυνση γραφής διαφέρει από το περιβάλλον περιεχόμενο, για παράδειγμα σε ένα εβραϊκό παράθεμα ενσωματωμένο σε αγγλική παράγραφο

Το PDF/UA-1 (ISO 14289-1 §7.2) απαιτεί η φυσική γλώσσα κάθε κομματιού κειμένου να προσδιορίζεται χωρίς ασάφεια. Το /WritingMode συμπληρώνει την ιδιότητα /Lang (SetStructElemLang): το /Lang δηλώνει ποια γλώσσα ομιλείται, ενώ το /WritingMode δηλώνει τη φυσική κατεύθυνση γραφής που πρέπει να χρησιμοποιήσει η υποβοηθούμενη τεχνολογία για την απόδοση

Παράδειγμα

// Arabic paragraph — right-to-left writing direction
PDFlib.BeginTagEx('P', '', '', 'ar-SA');
PDFlib.SetStructElemWritingMode('RlTb');
PDFlib.DrawText('...Arabic text...', 450, 700);
PDFlib.EndTag;

// Vertical CJK heading
PDFlib.BeginTagEx('H1', '', '', 'zh-TW');
PDFlib.SetStructElemWritingMode('TbRl');
PDFlib.DrawText('...CJK vertical text...', 500, 700);
PDFlib.EndTag;

Δείτε επίσης

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag