BeginTagExA

PDF etiquetado, Accesibilidad

Descripción

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

Abre un elemento de estructura de PDF etiquetado en la página actual con un atributo explícito de lenguaje natural Es idéntico a BeginTag, pero agrega un parámetro Lang que se escribe en el atributo /Lang del elemento de estructura's

Use esta función para contenido cuyo idioma difiera del idioma predeterminado del documento (establecido por SetPDFUAMode o SetDocumentLanguage) ISO 14289-1 §7.2 exige establecer el atributo /Lang en cualquier segmento de texto que no esté en el idioma principal del documento

Las etiquetas deben estar equilibradas: cada llamada a BeginTagEx debe ir seguida de una llamada correspondiente a EndTag. Las etiquetas pueden anidarse

Sintaxis

Delphi

Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);

Parámetros

TagType	Tipo de estructura estándar de PDF: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (véase ISO 32000-1 §14.8.4)
AltText	Texto alternativo para imágenes y otro contenido no textual (atributo `/Alt`). Pase una cadena vacía si no es necesario
ActualText	Texto de reemplazo para contenido cuya forma visual difiere de su significado lógico (atributo `/ActualText`). Pase una cadena vacía si no es necesario
Lang	Etiqueta de idioma BCP 47 para el contenido de este elemento, por ejemplo `en-US`, `fr-FR`, `zh-Hans`. Pase una cadena vacía para heredar el idioma del documento. Cuando no está vacía, reemplaza el idioma de nivel de documento para este elemento y todos sus descendientes

Valores devueltos

0	Falló (no hay ningún documento abierto)
1	La etiqueta se abrió correctamente

Ejemplo

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;