SetAutoTagMode

PDF etiquetado

Descripción

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

Sintaxis

Delphi

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

Parámetros

Mode	Una máscara de bits: `1` etiqueta texto, `2` marca el mobiliario de página como artefactos, `4` etiqueta imágenes como figuras, `8` etiqueta tablas dibujadas, `15` realiza las cuatro acciones y `0` la desactiva

Valores devueltos

Mode	El modo que estaba en vigor antes de esta llamada
0	También se devuelve cuando se proporciona un modo negativo, el cual se rechaza y deja el modo sin cambios

Observaciones

Con el etiquetado de texto activo, 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 repetitivos activo, los encabezados y pies de página se marcan como artefactos para que un lector los omita en vez de anunciar la misma línea en cada página

Con el etiquetado de figuras activado, una imagen dibujada se convierte en una figura que lleva la descripción dejada por RegisterFigure, o se dibuja dentro de un artefacto de diseño cuando RegisterDecoration indicó que no tiene significado

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

Activar el modo también marca el documento como etiquetado Un lector trata la estructura como ausente hasta que está presente esa marca, por lo que un documento etiquetado sin ella se lee como si no tuviera estructura alguna

El etiquetado automático se mantiene al margen dentro de una etiqueta abierta con BeginTag: mientras quien llama describe la estructura misma, no se anida nada dentro de lo que abrió. 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 espacio en blanco

El modo pertenece a la instancia de 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