SetStructElemWritingMode

Označeni PDF, Pristupačnost

Opis

Postavlja atribut /WritingMode (vlasnik atributa rasporeda) na strukturnom elementu trenutačno otvorenom na stogu oznaka. Način pisanja deklarira glavni smjer pisanja teksta unutar elementa i utječe na to kako pomoćna tehnologija tumači redoslijed čitanja. Ekvivalentno pozivu AddTagAttribute s Owner=Layout, Name=WritingMode i nazivom načina kao vrijednošću

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	Smjer pisanja elementa. Mora biti jedna od sljedećih vrijednosti (razlikuju se velika i mala slova): LrTb — slijeva nadesno, odozgo prema dolje (zadano; latinica, ćirilica, grčki i većina ostalih pisama) RlTb — zdesna nalijevo, odozgo prema dolje (arapski, hebrejski) TbRl — odozgo prema dolje, zdesna nalijevo (tradicionalni okomiti CJK tekst)

Povratna vrijednost

Vraća 1 pri uspjehu. Vraća 0 ako nije otvoren dokument ili na stogu oznaka trenutačno nije otvorena nijedna oznaka

Napomene

Ovu funkciju pozovite nakon BeginTag ili BeginTagEx i prije EndTag. Atribut /WritingMode definiran je u ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, tablica 340).

Kada dokument u cijelosti koristi dosljedan smjer pisanja, nije potrebno postavljati /WritingMode na svakom elementu — kad atribut nedostaje, primjenjuje se zadani LrTb. Atribut izričito postavite na elementima blokovske razine čiji se smjer pisanja razlikuje od okoline, primjerice hebrejski citat ugrađen u engleski odlomak.

PDF/UA-1 (ISO 14289-1 §7.2) zahtijeva da se prirodni jezik svakog dijela teksta može jednoznačno utvrditi. /WritingMode nadopunjuje atribut /Lang (SetStructElemLang): /Lang deklarira na kojem se jeziku govori, dok /WritingMode deklarira fizički smjer pisanja koji asistivna tehnologija treba upotrijebiti pri prikazu.

Primjer

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

Vidi također

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag