PDFium Delphi Component Docs

Método GenerateTaggedLayout

Componente: TPdf  ·  Unidades: PDFium, FPdfLayout

Sintaxis

function GenerateTaggedLayout(Layout: TPdfLayoutDocument; out Plan: TPdfLayoutPlan; const Language: string = 'en-US'): Boolean;

Descripción

Mide y emite un documento de composición nuevo, asigna MCIDs continuos a los objetos de página semánticos, marca el contenido decorativo como Artifact, construye la jerarquía de estructura y recarga el Tagged PDF terminado en el mismo TPdf

El destino debe estar inactivo o contener cero páginas, de modo que todo objeto que no sea artefacto quede cubierto por el plan semántico generado

El método carga PDFium antes de comprobar las capacidades de contenido marcado, por lo que puede ser la primera operación nativa de una instancia nueva de TPdf sin una llamada previa a CreateDocument

Modelo semántico

AddText usa plsrParagraph de manera predeterminada, mientras que los encabezados, pies de página, líneas, imágenes, XObjects de página y nodos en caché usan plsrArtifact

Llame a SetLastItemSemantics para asignar títulos, secciones, divisiones, figuras, leyendas, roles de lista, roles de tabla, texto alternativo, texto real, idioma, IDs, alcance de tabla, spans o IDs de encabezado

Use AddSemanticNode para contenedores de lista y tabla no visuales, y luego conecte los descendientes mediante ElementID y ParentID

Enlaces etiquetados

AddLink agrega texto URI medido y una anotación Link

La anotación generada se convierte en un objeto indirecto cuando es necesario, recibe una clave StructParent y se asocia con su elemento de estructura Link mediante entradas OBJR y ParentTree

Validación

La pasada de medición rechaza IDs duplicados, padres sin resolver, ciclos, contención inválida de listas o tablas, figuras sin texto alternativo o real, spans y alcance inválidos, e IDs de encabezado de tabla sin resolver

La generación rechaza salida cifrada, un árbol de estructura existente, cantidades de páginas u objetos que no coinciden, MCIDs duplicados, mapeos de anotación incompletos y excesos del presupuesto de objetos configurado

Resultado

Plan contiene elementos semánticos, índices de padres, MCIDs, índices de anotaciones de enlace, cantidades de contenido etiquetado y cantidades de artefactos, además de las métricas habituales de la composición

El documento terminado incluye un elemento de estructura Document, ParentTree, IDTree cuando hay IDs, MarkInfo, idioma del documento, StructParents de página y orden de tabulación basado en la estructura para las páginas con anotaciones

Tablas avanzadas

TPdfLayoutTableCell.AddTextRun conserva los estilos de texto mixtos como texto nativo extraíble; SetImage emite una Figure con texto alternativo dentro de la celda original

Con AllowRowSpanContinuation=True, un único TH o TD abarca todos sus fragmentos físicos de página mediante entradas MCR de cada página, conservando RowSpan, ColumnSpan y las relaciones con los encabezados

Las filas de subtotal siguen siendo filas del cuerpo y las etiquetas de continuación se marcan como Artifact; consulte FPdfLayout para conocer las restricciones y los límites de trabajo

Ver también

GenerateLayout, ValidatePdfUa, ReadableContent