BeginTagEx

PDF etiquetado, Accesibilidad

Descripción

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