SetStructElemWritingMode

Tagged PDF, Accessibility

Description

Legt den Eintrag /T (Titel) für das Strukturelement fest, das derzeit auf dem Tag-Stapel erstellt wird; der Titel ist eine lesbare Bezeichnung, die das spezifische Element charakterisiert — zum Beispiel Chapter 1, Summary Table oder Figure 3: Quarterly Sales —, anstatt lediglich den Elementtyp zu wiederholen

Syntax

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);

Parameters

WritingMode	Die Schreibrichtung für das Element. Muss einer der folgenden Werte sein (Groß-/Kleinschreibung beachten): LrTb — links nach rechts, oben nach unten (Standard; Lateinisch, Kyrillisch, Griechisch und die meisten Schriften) RlTb — rechts nach links, oben nach unten (Arabisch, Hebräisch) TbRl — oben nach unten, rechts nach links (traditioneller vertikaler CJK-Text)

Return value

Gibt 1 bei Erfolg zurück; gibt 0 zurück, wenn kein Dokument geöffnet ist oder derzeit kein Tag auf dem Tag-Stapel geöffnet ist

Remarks

Rufen Sie diese Funktion nach BeginTag oder BeginTagEx und vor EndTag auf; Das Attribut /WritingMode ist in ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, Tabelle 340) definiert

Wenn ein Dokument durchgehend eine einheitliche Schreibrichtung verwendet, ist es nicht erforderlich, /WritingMode für jedes Element festzulegen — der Standardwert LrTb gilt, wenn das Attribut fehlt. Legen Sie das Attribut explizit für Elemente auf Blockebene fest, deren Schreibrichtung vom umgebenden Inhalt abweicht, beispielsweise bei einem hebräischen Zitat, das in einen englischen Absatz eingebettet ist

PDF/UA-1 (ISO 14289-1 §7.2) erfordert, dass die natürliche Sprache jedes Textabschnitts eindeutig bestimmt werden kann; /WritingMode ergänzt das Attribut /Lang (SetStructElemLang): /Lang deklariert, welche Sprache gesprochen wird, während /WritingMode die physische Schreibrichtung deklariert, die assistierende Technologien für die Präsentation verwenden sollten

Example

// 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;