BeginTag

PDF etiquetado, Accesibilidad

Descripción

Abre un elemento etiquetado, escribe BDC y lo registra en el árbol lógico del documento, que se finaliza automáticamente al guardar

Las etiquetas deben estar equilibradas: cada llamada a BeginTag debe ir seguida de una llamada coincidente a EndTag. Las etiquetas se pueden anidar

Sintaxis

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

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

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

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 (se asigna al atributo PDF `/Alt`). Pase una cadena vacía si no es necesario
ActualText	Texto sustitutorio para contenido cuya representación visual difiere de su significado lógico (atributo PDF `/ActualText`). Pase una cadena vacía si no se necesita

Valores devueltos

0	Error (no hay ningún documento abierto)
1	La etiqueta se ha abierto correctamente

Ejemplo

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Observaciones

Utilice BeginArtifact/EndArtifact para contenido decorativo (encabezados, pies y elementos de fondo de página) que los lectores de pantalla no deban leer

El documento debe estar en modo de escritura. Llame a SetPDFUAMode antes de etiquetar para cumplir PDF/UA-1

Etiquetar marca el documento al guardarlo para que los lectores reconozcan la estructura. Se conserva el ajuste SetMarkInfo del llamador