BeginTagEx

PDF etiquetado, Accesibilidad

Descripción

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 TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * 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;