BeginTagExA

PDF etiquetado, Accesibilidad

Descripción

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

Abre un elemento etiquetado con idioma natural explícito. Es idéntico a BeginTag, pero añade Lang escrito en el atributo /Lang

Utilice esta función para contenido cuyo idioma difiera del idioma predeterminado del documento (establecido mediante SetPDFUAMode o SetDocumentLanguage). ISO 14289-1 §7.2 exige que el atributo /Lang se establezca 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 se pueden anidar

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 estructural PDF: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (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 sustitución 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` o `zh-Hans`. Pase una cadena vacía para heredar el idioma del documento. Cuando no está vacía, sustituye el idioma de nivel de documento para este elemento y todos sus descendientes

Valores devueltos

0	Error (no hay ningún documento abierto)
1	La etiqueta se ha abierto 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;