Docs de PDFiumPas

IsTagged Propiedad

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.
Componente: TPdf  ·  Unidad: PDFium
Indica si el documento declara un árbol de estructura para accesibilidad

Sintaxis

property IsTagged: Boolean; // solo lectura

Descripción

IsTagged devuelve True cuando el catálogo del documento referencia un /StructTreeRoot — la raíz del árbol lógico de estructura PDF (sección 14.7 de la especificación PDF 1.7). Los PDF etiquetados codifican el orden de lectura del documento, niveles de encabezado, estructura de tablas, listas, texto alternativo en imágenes y otro marcado semántico del que dependen los lectores de pantalla, los motores de reflujo y los extractores de contenido. PDF/UA-1 y la conformidad PDF/A-2a/3a requieren PDF etiquetado

La propiedad es False cuando Active es False, cuando no se declara ningún árbol de estructura o cuando el árbol de estructura está presente pero vacío Muchos PDF reales no están etiquetados — especialmente los documentos escaneados, la salida de controladores de impresión y las exportaciones de herramientas anteriores a 2010. El soporte de PDF etiquetado en las herramientas de autoría está mejorando, pero sigue siendo irregular

IsTagged es una comprobación barata de cabecera, adecuada para decisiones de enrutado: omite la extracción del árbol de estructura en archivos sin etiquetar (simplemente devolverá arrays vacíos) o muestra un aviso de accesibilidad al operador. El árbol detallado está disponible a través de StructureElements, que materializa el árbol en un array plano de registros TPdfStructureElement con nivel, índice de padre, nombre de tipo y rol

Notas

Ejemplo

if not Pdf1.IsTagged then
  Log.Add('Warning: PDF is not tagged. Screen-reader output will be unreliable.');
if Pdf1.IsTagged and (Pdf1.Language = '') then
  Log.Add('Tagged PDF without /Lang - fails PDF/UA.');

Véase también

StructureElements, Language, FormType