BeginTagA

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 BeginTag y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual

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 DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;

DLL

int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * 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