SetStructElemWritingMode

Getagde PDF, toegankelijkheid

Beschrijving

Zet het attribuut /WritingMode (Layout-attribuuteigenaar) op het structuurelement dat momenteel open staat op de tagstack. De schrijfmodus verklaart de hoofdschrijfrichting van tekst binnen het element en beïnvloedt hoe hulptechnologie de leesvolgorde interpreteert. Gelijk aan het aanroepen van AddTagAttribute met Owner=Layout, Name=WritingMode en de modusnaam als waarde

Syntaxis

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

Parameters

WritingMode	De schrijfrichting van het element. Dit moet een van de volgende hoofdlettergevoelige waarden zijn: LrTb — van links naar rechts, van boven naar beneden (standaard; Latijn, Cyrillisch, Grieks en de meeste schriften) RlTb — van rechts naar links, van boven naar beneden (Arabisch, Hebreeuws) TbRl — van boven naar beneden, van rechts naar links (traditionele verticale CJK-tekst)

Retourwaarde

Retourneert 1 bij succes. Retourneert 0 als er geen document is geopend of momenteel geen tag op de tagstack geopend is

Opmerkingen

Roep deze functie aan na BeginTag of BeginTagEx en vóór EndTag. Het attribuut /WritingMode is gedefinieerd in ISO 32000-1 §14.8.5.4.2 (Layout-attribuuteigenaar, Table 340)

Wanneer een document overal dezelfde schrijfrichting gebruikt, hoeft /WritingMode niet voor elk element te worden ingesteld — de standaardwaarde LrTb wordt gebruikt wanneer het attribuut ontbreekt. Stel het attribuut expliciet in op block-level-elementen waarvan de schrijfrichting afwijkt van de omringende inhoud, bijvoorbeeld op een Hebreeuws citaat in een Engelse alinea

PDF/UA-1 (ISO 14289-1 §7.2) eist dat de natuurlijke taal van elk stuk tekst eenduidig vaststelbaar is. /WritingMode vult het attribuut /Lang (SetStructElemLang) aan: /Lang verklaart welke taal wordt gesproken, /WritingMode verklaart de fysieke schrijfrichting die hulptechnologie voor de presentatie moet gebruiken

Voorbeeld

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

Zie ook

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag