BeginTagA

PDF etiquetado, Accesibilidad

Descripción

La A final indica el punto de entrada ANSI (char) de la DLL; 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 actual de SetAnsiMode

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