SetAutoTagMode

PDF etiquetado

Descripción

Activa el etiquetado de estructura que llevan por sí mismas las llamadas de dibujo normales

Sintaxis

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Parámetros

Mode	Máscara: `1` etiqueta texto, `2` marca mobiliario como artefacto, `4` imágenes, `8` tablas, `15` todo, `0` desactiva

Valores devueltos

Mode	El modo que estaba vigente antes de esta llamada
0	También se devuelve cuando se proporciona un modo negativo, que se rechaza sin modificar el modo

Observaciones

Con el etiquetado de texto activado, el texto se etiqueta como párrafo y el texto dibujado inmediatamente después de RegisterHeading se etiqueta como encabezado de ese nivel. Con el marcado de elementos accesorios activado, los encabezados y pies de página continuos se marcan como artefactos para que el lector los omita en vez de anunciar la misma línea en cada página

Con etiquetado de figuras, una imagen usa la descripción de RegisterFigure o se dibuja como artefacto si RegisterDecoration la declaró decorativa

Con el etiquetado de tablas activado, DrawTableRows incorpora al árbol de estructura la tabla, sus filas y sus celdas. Las filas indicadas mediante SetTableHeaderRowCount se convierten en celdas de encabezado

Activar el modo también marca el documento como etiquetado. Un lector considera que la estructura no existe hasta que aparece esa marca, por lo que un documento etiquetado sin ella se lee como si careciera por completo de estructura

El etiquetado automático no interviene dentro de una etiqueta abierta mediante BeginTag: mientras el autor de la llamada describe la propia estructura, no se anida nada dentro de lo que ha abierto. Tampoco etiqueta nunca dentro de un artefacto, donde un elemento de estructura invalidaría el archivo, ni abre un elemento para texto vacío, que un lector anunciaría como un espacio en blanco

El modo pertenece a la instancia de la biblioteca, no a un documento

Ejemplo

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Véase también

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount