SetStructElemLangA

PDF etiquetado & accesibilidad

Descripción

La A final indica el punto de entrada ANSI (char) de la DLL; la interfaz ActiveX/COM expone únicamente la forma Unicode. El comportamiento es idéntico a SetStructElemLang y los argumentos de cadena se interpretan utilizando la página de códigos actual de SetAnsiMode

Establece la entrada /Lang en el elemento de estructura que se está creando actualmente en la pila de etiquetas La etiqueta de idioma reemplaza el idioma a nivel de documento para este elemento y todos sus descendientes, lo que permite que los documentos multilingües declaren el idioma natural correcto para cada tramo de contenido

Sintaxis

Delphi

Function DLSetStructElemLangA(InstanceID: Integer; Lang: PAnsiChar): Integer;

DLL

int DLSetStructElemLangA(int InstanceID, const char * Lang);

Parámetros

LangUna cadena de etiqueta de idioma BCP 47, como en-US, fr, de-CH o zh-Hant-TW Pase una cadena vacía para borrar un valor establecido previamente y heredar el idioma a nivel de documento

Valor devuelto

Devuelve 1 si tiene éxito, 0 si no hay ningún elemento de estructura abierto actualmente o no hay ningún documento seleccionado

Observaciones

Llame a esta función inmediatamente después de BeginTag o BeginTagEx mientras el elemento de destino esté en la parte superior de la pila de etiquetas. Equivale a pasar un argumento Lang no vacío a BeginTagEx, pero puede ser más práctico cuando el idioma se determina por separado del tipo de elemento

La entrada /Lang a nivel de elemento se define en ISO 32000-1 §14.9.2 Se aplica al elemento de estructura y, por herencia, a todos los elementos secundarios que no declaran por sí mismos un /Lang Los lectores de pantalla usan esta entrada para seleccionar la voz de texto a voz o el motor de idioma adecuado al leer el documento en voz alta

PDF/UA-1 (ISO 14289-1 §7.3) requiere identificar todo el contenido en lenguaje natural. El /Lang de nivel de documento establecido por SetDocumentLanguage o SetPDFUAMode cubre el idioma principal; SetStructElemLang cubre las secciones cuyo idioma difiere del principal

Ejemplo

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

Véase también

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics