SetStructElemWritingMode

PDF con tag, accessibilità

Descrizione

Imposta l'attributo /WritingMode (proprietario degli attributi Layout) sull'elemento di struttura attualmente aperto nello stack dei tag. La modalità di scrittura dichiara la direzione principale del testo nell'elemento e influisce sul modo in cui le tecnologie assistive interpretano l'ordine di lettura. Equivale a chiamare AddTagAttribute con Owner=Layout, Name=WritingMode e il nome della modalità come valore

Sintassi

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	Direzione di scrittura dell'elemento. Deve essere uno dei valori seguenti, con distinzione tra maiuscole e minuscole: LrTb — da sinistra a destra e dall'alto verso il basso (impostazione predefinita; latino, cirillico, greco e gran parte delle scritture) RlTb — da destra a sinistra e dall'alto verso il basso (arabo, ebraico) TbRl — dall'alto verso il basso e da destra a sinistra (testo verticale CJK tradizionale)

WritingMode

Direzione di scrittura dell'elemento. Deve essere uno dei valori seguenti, con distinzione tra maiuscole e minuscole:

LrTb — da sinistra a destra e dall'alto verso il basso (impostazione predefinita; latino, cirillico, greco e gran parte delle scritture)
RlTb — da destra a sinistra e dall'alto verso il basso (arabo, ebraico)
TbRl — dall'alto verso il basso e da destra a sinistra (testo verticale CJK tradizionale)

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun documento o tag è attualmente aperto

Note

Chiamare questa funzione dopo BeginTag o BeginTagEx e prima di EndTag. L'attributo /WritingMode è definito in ISO 32000-1 §14.8.5.4.2 (proprietario degli attributi Layout, Table 340)

Quando un documento usa ovunque una direzione di scrittura coerente, non è necessario impostare /WritingMode su ogni elemento: in assenza dell'attributo si applica il valore predefinito LrTb. Impostare esplicitamente l'attributo sugli elementi a livello di blocco la cui direzione di scrittura differisce dal contenuto circostante, ad esempio una citazione in ebraico incorporata in un paragrafo in inglese

PDF/UA-1 (ISO 14289-1 §7.2) richiede che la lingua naturale di ogni testo sia determinabile senza ambiguità. /WritingMode integra /Lang (SetStructElemLang): /Lang dichiara la lingua parlata, mentre /WritingMode dichiara la direzione fisica di scrittura da usare per la presentazione

Esempio

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

Vedere anche

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag