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 nuevo documento de diseño, asigna MCID continuos a los objetos de página semánticos, marca el contenido decorativo como Artifact, construye la jerarquía de estructura y vuelve a cargar el Tagged PDF completado en el mismo TPdf

El destino debe estar inactivo o no contener páginas, de modo que cada objeto no decorativo 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 TPdf nueva sin una llamada previa a CreateDocument

Modelo semántico

AddText usa plsrParagraph por defecto, mientras que encabezados, pies, líneas, imágenes, XObjects de página y nodos cacheados usan plsrArtifact por defecto

Llame a SetLastItemSemantics para asignar encabezados, secciones, divisiones, figuras, leyendas, roles de lista, roles de tabla, texto alternativo, texto actual, idioma, IDs, scope 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 añade 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 de lista o tabla no válida, figuras sin texto alternativo o actual, spans y scope no válidos, e IDs de encabezado de tabla sin resolver

La generación rechaza salida cifrada, un árbol de estructura existente, recuentos de páginas u objetos que no coincidan, 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 Link, recuentos de contenido etiquetado y recuentos de artifacts, además de las métricas de diseño ordinarias

El documento completado 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 páginas con anotaciones

Tablas avanzadas

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

Con AllowRowSpanContinuation=True, un único TH o TD abarca todos sus fragmentos físicos de página mediante entradas MCR por página y conserva RowSpan, ColumnSpan y las relaciones de cabecera

Las filas de subtotales siguen siendo filas del cuerpo y las etiquetas de continuación se marcan como Artifact; consulte FPdfLayout para las restricciones y los presupuestos

Véase también

GenerateLayout, ValidatePdfUa, ReadableContent