BeginTag

PDF etiquetado, Accesibilidad

Descripción

Abre un elemento de estructura de PDF etiquetado en la página actual Escribe un operador BDC (Begin Marked Content with Dictionary) en el flujo de contenido y registra el elemento en el árbol de estructura lógica del documento El árbol de estructura se finaliza automáticamente al guardar el documento

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

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

Valores devueltos

0	Falló (no hay ningún documento abierto)
1	La etiqueta se abrió 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

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

El documento debe estar en modo de escritura (creado o abierto para modificación) Llame a SetPDFUAMode antes de etiquetar para satisfacer los requisitos de PDF/UA-1

Etiquetar un documento lo marca como etiquetado cuando se guarda, lo que un lector necesita antes de tratar la estructura como presente. La configuración de SetMarkInfo realizada por quien llama se deja tal como está