SetStructElemWritingMode

PDF etichetat, Accesibilitate

Descriere

Setează atributul /WritingMode (proprietarul de atribute Layout) pe elementul de structură deschis în prezent pe stiva de tag-uri. Modul de scriere declară direcția principală de scriere a textului în interiorul elementului și afectează modul în care tehnologia asistivă interpretează ordinea de citire. Echivalentă cu apelarea AddTagAttribute cu Owner=Layout, Name=WritingMode și numele modului ca valoare

Sintaxă

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	Direcția de scriere pentru element. Trebuie să fie una dintre următoarele valori (cu distincție între majuscule și minuscule): LrTb — de la stânga la dreapta, de sus în jos (implicit; latin, chirilic, grecesc și majoritatea scripturilor) RlTb — de la dreapta la stânga, de sus în jos (arabă, ebraică) TbRl — de sus în jos, de la dreapta la stânga (text vertical CJK tradițional)

WritingMode

Direcția de scriere pentru element. Trebuie să fie una dintre următoarele valori (cu distincție între majuscule și minuscule):

LrTb — de la stânga la dreapta, de sus în jos (implicit; latin, chirilic, grecesc și majoritatea scripturilor)
RlTb — de la dreapta la stânga, de sus în jos (arabă, ebraică)
TbRl — de sus în jos, de la dreapta la stânga (text vertical CJK tradițional)

Valoare returnată

Returnează 1 în caz de succes. Returnează 0 dacă niciun document nu este deschis sau dacă nu există niciun tag deschis în stiva de tag-uri

Observații

Apelați această funcție după BeginTag sau BeginTagEx și înainte de EndTag. Atributul /WritingMode este definit în ISO 32000-1 §14.8.5.4.2 (deținător de atribute Layout, Table 340)

Când un document folosește o direcție de scriere consistentă pe tot parcursul, nu este necesar să setați /WritingMode pe fiecare element — implicitul LrTb se aplică când atributul lipsește. Setați atributul explicit pe elementele de nivel de bloc a căror direcție de scriere diferă de conținutul din jur, de exemplu o citație în ebraică înglobată într-un paragraf în engleză

PDF/UA-1 (ISO 14289-1 §7.2) cere ca limba naturală a fiecărei porțiuni de text să poată fi determinată fără ambiguitate. /WritingMode completează atributul /Lang (SetStructElemLang): /Lang declară ce limbă este rostită, în timp ce /WritingMode declară direcția fizică de scriere pe care tehnologia asistivă ar trebui să o folosească pentru prezentare

Exemplu

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

Consultați și

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag