SetStructElemLangA

PDF etiquetado & accesibilidad

Descripción

El sufijo A indica el punto de entrada ANSI (char) de la DLL; la superficie 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 SetAnsiMode actual

Establece /Lang en el elemento actual. Sobrescribe el idioma del documento para él y sus descendientes, permitiendo declarar correctamente contenido multilingüe

Sintaxis

Delphi

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

DLL

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

Parámetros

Valor devuelto

Devuelve 1 si la operación se realiza correctamente, o 0 si no hay ningún elemento de estructura abierto o 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 resultar más práctico cuando el idioma se determina por separado del tipo de elemento

/Lang de elemento se define en ISO 32000-1 §14.9.2 y se hereda a hijos sin /Lang. Los lectores lo usan para elegir voz o motor de idioma

PDF/UA-1 (ISO 14289-1 §7.3) exige que se identifique todo el contenido en lenguaje natural. El valor /Lang a nivel de documento establecido por SetDocumentLanguage o SetPDFUAMode abarca el idioma principal; SetStructElemLang abarca 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