SetStructElemWritingMode

Tagovaný PDF, prístupnosť

Opis

Nastaví atribút /WritingMode (vlastník atribútov Layout) na štruktúrnom prvku aktuálne otvorenom na zásobníku tagov. Režim písania deklaruje hlavný smer písania textu vnútri prvku a ovplyvňuje, ako asistívna technológia interpretuje poradie čítania. Ekvivalent volania AddTagAttribute s Owner=Layout, Name=WritingMode a názvom režimu ako hodnotou.

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

Parametre

WritingMode	Smer písania prvku. Musí to byť jedna z týchto hodnôt (rozlišuje sa veľkosť písmen): LrTb — zľava doprava, zhora nadol (predvolené; latinka, cyrilika, gréčtina a väčšina ostatných písiem) RlTb — sprava doľava, zhora nadol (arabčina, hebrejčina) TbRl — zhora nadol, sprava doľava (tradičný zvislý text CJK)

Návratová hodnota

Vráti 1 pri úspechu. Vráti 0, ak nie je otvorený žiadny dokument alebo sa na zásobníku tagov práve neotvára žiadny tag

Poznámky

Túto funkciu zavolajte po BeginTag alebo BeginTagEx a pred EndTag. Atribút /WritingMode je definovaný v ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, tabuľka 340).

Keď dokument používa v celom priebehu konzistentný smer písania, nie je potrebné nastavovať /WritingMode na každom prvku — keď atribút chýba, platí predvolené LrTb. Atribút nastavte výslovne na prvkoch blokovej úrovne, ktorých smer písania sa líši od okolia, napríklad hebrejská citácia vložená do anglického odseku.

PDF/UA-1 (ISO 14289-1 §7.2) vyžaduje, aby bolo možné jednoznačne určiť prirodzený jazyk každého textu. /WritingMode dopĺňa atribút /Lang (SetStructElemLang): /Lang deklaruje, akým jazykom sa hovorí, zatiaľ čo /WritingMode deklaruje fyzický smer písania, ktorý má asistívna technológia použiť pri prezentácii.

Príklad

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

Pozri tiež

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag