SetStructElemWritingModeA

Tagged PDF, Accessibility

Description

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med SetStructElemWritingMode och strängargument tolkas med aktuell SetAnsiMode-kod sida

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 DLSetStructElemWritingModeA(InstanceID: Integer; WritingMode: PAnsiChar): Integer;

DLL

int DLSetStructElemWritingModeA(int InstanceID, const char * WritingMode);

Parameters

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)

Return value

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

Remarks

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

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;