SetStructElemWritingMode

Označeni PDF, Dostopnost

Opis

Na strukturnem elementu, trenutno odprtemu na skladu oznak, nastavi atribut /WritingMode (lastnik atributov Layout). Način pisanja napove glavno smer pisanja besedila znotraj elementa in vpliva na to, kako podporna tehnologija tolmači vrstni red branja. Enakovredno klicu AddTagAttribute z Owner=Layout, Name=WritingMode in imenom načina kot vrednostjo

Sintaksa

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

Parametri

WritingMode	pisalna smer elementa. Mora biti ena od naslednjih vrednosti (ločevanje velikih in malih črk): LrTb — od leve proti desni, od zgoraj navzdol (privzeto; latinica, cirilica, grščina in večina drugih pisem) RlTb — od desne proti levi, od zgoraj navzdol (arabščina, hebrejščina) TbRl — od zgoraj navzdol, od desne proti levi (tradicionalno navpično besedilo CJK)

Vrnjena vrednost

Ob uspehu vrne 1. Vrne 0, če noben dokument ni odprt ali na skladu oznak trenutno ni odprta nobena oznaka

Opombe

Funkcijo pokličite po BeginTag ali BeginTagEx in pred EndTag. Atribut /WritingMode je definiran v ISO 32000-1 §14.8.5.4.2 (lastnik atributov postavitve, tabela 340)

Kadar dokument v celoti uporablja dosledno pisalno smer, ni treba nastaviti /WritingMode na vsakem elementu — kadar atribut manjka, velja privzeti LrTb. Atribut izrecno nastavite na elementih na ravni bloka, katerih pisalna smer se razlikuje od okoliške vsebine, na primer hebrejski navedek v angleškem odstavku

PDF/UA-1 (ISO 14289-1 §7.2) zahteva, da je naravni jezik vsakega dela besedila enoznačno določljiv. /WritingMode dopolnjuje atribut /Lang (SetStructElemLang): /Lang izjavlja, kateri jezik se govori, /WritingMode pa fizično pisalno smer, ki naj jo pomožna tehnologija uporabi za predstavitev

Primer

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

Glejte tudi

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag