SetStructElemLang

PDF con tag & accessibilità

Descrizione

Imposta la voce /Lang sull'elemento della struttura attualmente in creazione nello stack dei tag. Il tag della lingua sostituisce la lingua a livello di documento per questo elemento e tutti i relativi discendenti, consentendo ai documenti multilingue di dichiarare la lingua naturale corretta per ciascun intervallo di contenuto

Sintassi

Delphi

Function TPDFlib.SetStructElemLang(Const Lang: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemLang(Lang As String) As Long

DLL

int DLSetStructElemLang(int InstanceID, const wchar_t * Lang);

Parametri

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun elemento della struttura è aperto o nessun documento è selezionato

Note

Chiamare questa funzione subito dopo BeginTag o BeginTagEx, mentre l'elemento di destinazione si trova in cima allo stack dei tag. Equivale a passare un argomento Lang non vuoto a BeginTagEx, ma può risultare più pratico quando la lingua viene determinata separatamente dal tipo di elemento

La voce /Lang a livello di elemento è definita in ISO 32000-1 §14.9.2. Si applica all'elemento della struttura e, per ereditarietà, a tutti gli elementi figli che non dichiarano a loro volta un valore /Lang. Gli screen reader usano questa voce per selezionare la voce di sintesi vocale o il motore linguistico appropriato durante la lettura ad alta voce del documento

PDF/UA-1 (ISO 14289-1 §7.3) richiede l'identificazione di tutti i contenuti in lingua naturale. Il valore /Lang a livello di documento, impostato da SetDocumentLanguage o SetPDFUAMode, copre la lingua principale; SetStructElemLang copre le sezioni la cui lingua differisce da quella principale

Esempio

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

Vedere anche

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics