SetStructElemWritingMode

Taggad PDF, tillgänglighet

Beskrivning

Sätter /WritingMode-attributet (Layout-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Skrivläget deklarerar den huvudsakliga skrivriktningen för text inom elementet och påverkar hur hjälpmedelsteknik tolkar läsordningen. Ekvivalent med att anropa AddTagAttribute med Owner=Layout, Name=WritingMode och lägesnamnet som värde

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

Parametrar

WritingMode	Skrivriktningen för elementet. Måste vara ett av följande värden (skiftlägeskänsligt): LrTb — vänster till höger, uppifrån och ned (standard; latinska, kyrilliska, grekiska och de flesta skrifter) RlTb — höger till vänster, uppifrån och ned (arabiska, hebreiska) TbRl — uppifrån och ned, höger till vänster (traditionell vertikal CJK-text)

Returvärde

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Anmärkningar

Anropa den här funktionen efter BeginTag eller BeginTagEx och före EndTag. Attributet /WritingMode är definierat i ISO 32000-1 §14.8.5.4.2 (Layout-attributägare, tabell 340)

När ett dokument använder en konsekvent skrivriktning genomgående behövs det inte att sätta /WritingMode på varje element — standardvärdet LrTb gäller när attributet saknas. Sätt attributet explicit på blocknivåelement vars skrivriktning skiljer sig från den omgivande texten, till exempel ett hebreiskt citat inbäddat i ett engelskt stycke

PDF/UA-1 (ISO 14289-1 §7.2) kräver att det naturliga språket för varje textbit går att avgöra entydigt. /WritingMode kompletterar attributet /Lang (SetStructElemLang): /Lang deklarerar vilket språk som läses upp, medan /WritingMode deklarerar den fysiska skrivriktning hjälpmedelsteknik bör använda vid presentation

Exempel

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

Se även

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag