Renderizado y exportación avanzados

Las rutas de PDF, SVG, mapa de bits, metarchivo, vista previa e impresión comparten un mismo modelo de paginación y una geometría independiente del backend, al tiempo que conservan codificadores específicos de formato

Backends gráficos personalizados

TXLSGraphicsTextAlign define la alineación de texto a la izquierda, al centro y a la derecha para TXLSGraphicsBackend; las llamadas de dibujo con estilo reciben el resto de enums compartidos: estilos de fuente (TXLSGraphicsFontStyles), extremos de línea (TXLSGraphicsLineCap), patrones de guiones (TXLSGraphicsLineDash) y alineación vertical del texto (TXLSGraphicsTextVAlign)

Las implementaciones reciben coordenadas en puntos, los efectos de texto e imagen resueltos, el recorte y la colocación de dibujo local a la página, sin necesidad de repetir la lógica de diseño del libro. Cada dibujo de una página lógica llega como un registro TXLSPageDrawingPlacement cuyo Kind (TXLSPageDrawingKind: xpdkImage, xpdkChart, xpdkTextBox, xpdkShape, xpdkControl) indica al backend qué está pintando; los mosaicos del fondo de la hoja de cálculo llegan como TXLSSheetBackgroundRenderData

Geometría de renderizado propia de la operación

TXLSPaginationModel.RenderBackend selecciona la identidad del backend que capturará la siguiente llamada a Build , y RenderGeometry expone la calibración inmutable resultante, la generación del libro, el backend y el estado acotado de la caché de métricas; la sesión de render activa viaja como un handle TXLSRenderSession y la política de color es un TXLSRenderColorMode (xlsrcColor o xlsrcMonochrome)

Los modelos PDF usan xlsrgbPdf, SVG usa xlsrgbSvg, las imágenes de página usan xlsrgbBitmap, los modelos de impresión y vista previa usan xlsrgbPrintPreview, y TXLSWorkbookViewer usa xlsrgbViewer; PaginationModel en los componentes SVG, imagen, impresión y visor expone el modelo activo para diagnósticos sin transferir la propiedad

Los puntos de entrada HTML de XLS clásico y XLSX capturan xlsrgbHtml; TXLSHTMLExport.RenderGeometry expone la instantánea más reciente del Classic, mientras que TXLSXHtmlExportSession.RenderGeometry expone la instantánea retenida a través de todas las hojas en una exportación incremental

La salida HTML de columnas convierte el modelo de anchuras de caracteres del libro a través de la anchura máxima de dígito de la fuente Normal y del escalado de pantalla configurado antes de emitir una longitud fija en píxeles CSS; la conversión entre puntos y píxeles usa el mismo DPI de medición capturado

Cada operación conserva su calibración capturada aunque el libro cambie después, y el renderizado nunca escribe alturas de fila ni anchuras de columna de la hoja de cálculo. La paginación construye páginas a partir de objetos TXLSLogicalPage cuyos dibujos, orientación (TXLSPageOrientation: xpoPortrait o xpoLandscape) y colocación de comentarios (TXLSPrintComments: xpcNone o xpcAtEnd) provienen de la configuración de página resuelta

Una página lógica expone todo lo que un backend o un callback necesita: identidad (DocumentPageNumber, SheetPageNumber, SheetName, la ClassicWorksheet o XlsxWorksheetpropietaria), geometría (PageWidth, PageHeight, Scaley los valores LeftMargin, RightMargin, TopMargin, BottomMargin, HeaderMarginy FooterMargin ), el rectángulo de datos (DataFirstRow, DataLastRow, DataFirstCol, DataLastCol) con títulos de impresión (RepeatFirstRow, RepeatLastRow, RepeatFirstCol, RepeatLastCol), la colocación del fondo (BackgroundOffsetX, BackgroundOffsetY), la salida de líneas de cuadrícula (PrintGridlines, GridlineColor), los seis textos de bandas de encabezado y pie (LeftHeader, CenterHeader, RightHeader, LeftFooter, CenterFooter, RightFooter) y los esqueletos de filas y columnas de la página (RowCount con Rows y RowEdges, ColumnCount con Columns y ColumnEdges) más su lista de dibujos (DrawingCount y Drawings). ExpandHeaderFooter resuelve los códigos de formato de encabezado y pie contra la página, y ExpandHeaderFooterStyled informa además del tamaño de punto inicial y del color para que los pintores personalizados puedan igualar el renderizado de encabezados del propio Excel

Celdas combinadas en la paginación nativa

TXLSPaginationModel.RenderPageToBackend resuelve un rango combinado a su ancla original y pinta un rectángulo visible por cada fragmento de página; las celdas cubiertas no emiten texto duplicado ni líneas de cuadrícula internas

Los fragmentos XLSX comparten el relleno, la alineación, el ajuste de línea, la fuente y la evaluación de formato condicional del ancla, mientras que los segmentos de borde exterior explícitos siguen visibles y los bordes internos de la combinación se suprimen; los fragmentos clásicos comparten el texto y el relleno sólido del ancla a través del pintor de texto clásico existente

Un área de impresión o un salto de página pueden recortar un rango combinado, y cada fragmento visible usa el ancla original incluso cuando esa ancla queda fuera del área impresa; las filas y columnas ocultas aportan extensión cero, y los fragmentos repetidos de títulos de impresión usan la misma política de ancla

Combinar no fuerza un rango a una sola página, no expande el área de impresión ni cambia los altos de fila y anchos de columna almacenados; la paginación conserva la configuración de página existente y recorta cada fragmento a su página lógica

Renderizado del fondo de la hoja de cálculo

El visor de libros muestra los fondos válidos de hojas Classic y XLSX como mosaicos repetidos detrás de las celdas sin relleno, mientras que los rellenos explícitos y condicionales de celda permanecen por encima del fondo

TXLSPaginationModel, TXLSSvgExport, TXLSPageImageExporter, TXLSPrintDocument, TXLSPDFExport, TXLSHTMLExport, TXLSXHtmlExportOptionsy TXLSWorkbookViewer exponen ExportSheetBackgroundImages; el valor por defecto es False para la salida de impresión, vista previa, metarchivo, PDF, SVG, mapa de bits y HTML. Las hojas de cálculo almacenan su payload con un formato de imagen TXLSSheetBackgroundFormat , y los bytes decodificados viajan como un TXLSSheetBackgroundResource claveado por generación, DPI y modo de color

La salida paginada habilitada ancla la fase de mosaico a las coordenadas de la hoja de cálculo a través de los límites de página y retiene una imagen decodificada por hoja de cálculo, generación de recursos, backend, DPI y modo de color durante la sesión de render; BackgroundDecodeCount expone el total de decodificaciones para diagnósticos, mientras que los payloads corruptos se omiten con un diagnóstico del libro. La TXLSRenderSession activa gestiona esa caché compartida por sí misma: AcquireBackground obtiene (o decodifica una sola vez) la TXLSSheetBackgroundRenderData en mosaico de una hoja de cálculo, DrawTiledBackground la pinta en una región de página recortada, y DecodeCount informa de cuántos payloads se han decodificado hasta el momento

Política de visualización de objetos del libro

ObjectDisplayMode selecciona xlsodmShowAll, xlsodmShowPlaceholderso xlsodmHideAll tanto para libros XLS Classic como XLSX; el visor consume los tres estados y usa cajas de tipo, nombre, texto y texto alternativo de bajo coste para el modo placeholder

Los exportadores de PDF, SVG, mapa de bits, impresión física y HTML XLSX tratan el modo placeholder como salida de objetos completa por defecto; establezca ExportObjectPlaceholders en el exportador o en las opciones HTML correspondientes para solicitar cajas sin decodificación de imágenes ni construcción de escenas de gráficos

xlsodmHideAll es una compuerta global anterior que impide la recolección de dibujos, la expansión de rangos dirigida por objetos, el hit testing y el renderizado de medios; los fondos de hoja de cálculo, los iconos de formato condicional, las imágenes de encabezado o pie, las celdas y los filtros de impresión de objetos específicos de cada exportador permanecen independientes

Refresco de los datos de origen de gráficos

La serialización de gráficos XLSX y el renderizado compartido de gráficos resuelven las cachés locales de series contra la generación actual del libro, de modo que las ediciones de celdas de origen, el recálculo y los cambios de visibilidad refrescan valores, categorías, tamaños de burbuja y nombres de series enlazados a rangos antes de la salida

Los rangos de origen ordinarios deben ser una única fila o columna de referencias A1 locales; se admiten los nombres de hoja entrecomillados, y un rango sin cualificar se resuelve contra la hoja propietaria del gráfico; los niveles jerárquicos de categorías conservan su resolutor independiente de rangos rectangulares

El texto de categoría usa el texto formateado de la celda, las cachés numéricas conservan ranuras de puntos vacías para los blancos y el texto no numérico, las celdas de error conservan sus literales de error mostrados, y las fechas usan el sistema de seriales 1900 o 1904 del libro; PlotVisibleOnly determina si se omiten las filas y columnas de origen ocultas

Las cachés importadas o pobladas manualmente se conservan cuando un origen local nunca se ha materializado, mientras que las cachés ya gestionadas desde celdas locales limpian los puntos obsoletos tras el borrado; TXLSXChartSeries.RefreshDataCaches refresca explícitamente los orígenes locales resolubles, incluido un rango de origen vacío

Las referencias a libros externos y las expresiones de referencia no admitidas conservan sus cachés almacenadas; el refresco de cachés no abre archivos externos ni realiza peticiones de red

Ejes de fecha de gráficos conscientes del calendario

TXLSXChartSeries.ResolveDataCaches resuelve los orígenes locales de serie admitidos para la generación actual, y RefreshDataCaches solicita un refresco explícito incluso cuando un origen vacío no tiene historial de celdas

Los gráficos XLSX cuyo eje de categorías usa xlsxAxisDate mapean cada categoría válida a través del sistema de fechas seriales 1900 o 1904 del libro y conservan la distancia real entre fechas dispersas en lugar de asignar ranuras de puntos equidistantes

BaseTimeUnit controla la normalización por día, mes o año, mientras que MajorUnit, MinorUnit, MajorTimeUnity MinorTimeUnit avanzan las marcas por unidades de calendario; por ello los intervalos de meses y años siguen alineados entre longitudes de mes desiguales y años bisiestos

La misma colección acotada de marcas suministra coordenadas, etiquetas, ticks y las líneas de cuadrícula solicitadas a la salida PDF, SVG, mapa de bits, vista previa, impresión y visor basada en paginación, mientras que el HTML XLSX usa la misma aritmética de calendario para su SVG de gráfico en línea

Escritor PDF independiente

TXLSPDFWriter crea documentos PDF que no provienen de un libro, como facturas, entradas, etiquetas y formularios de superposición; BeginDoc establece una caja de página con precisión de puntos, NewPage cierra la página actual, y SaveToStream o SaveToFile finaliza el documento

Los métodos de dibujo usan puntos PDF desde la esquina inferior izquierda y colores de la biblioteca en forma $00BBGGRR o $AABBGGRR ; las primitivas disponibles cubren FillRectangle, StrokeRectangle, ClipRectangle, MeasureText, SaveGraphicsStatey RestoreGraphicsState para rectángulos rellenos y con trazo, líneas, elipses, texto con estilo y medición exacta de anchura, transformaciones afines, recorte rectangular y guardado o restauración explícita del estado gráfico, mientras que PageWidth y PageHeight informan de la caja de página actual en puntos

Exportación SVG

TXLSSvgExport proporciona siete sobrecargas de SaveAsSVG para rangos clásicos y XLSX, hojas de cálculo, libros y páginas lógicas preparadas, además de salida de objetos con nombre donde se admite

UseWorksheetPageSetup, Orientationy Margin utilizan las mismas decisiones de configuración de página que la salida PDF y de vista previa

TXLSSvgExport.PrintComments (tipo TXLSPrintComments) selecciona cómo se emiten los comentarios de celda en la salida SVG paginada; cuando vale xpcAtEnd, la última página de la hoja añade una lista de comentarios (dirección de celda, autor y texto) debajo del área de datos, mientras que xpcNone omite los comentarios

ExportPages envía un documento SVG completo cada vez a través de OnPage, informa del número de páginas confirmadas mediante ExportedPageCounty se detiene antes de generar páginas posteriores cuando el callback cancela; IdPrefix crea espacios de nombres de documento y página deterministas para clip paths, filtros, patrones y recursos compartidos

HyperlinkMode (tipo TXLSSvgHyperlinkMode) con xshmSafe añade regiones de impacto transparentes y recortadas después del contenido visual; los esquemas externos permitidos son HTTP, HTTPS, correo, FTP y enlaces relativos, mientras que los destinos activos, locales, UNC y con caracteres de control se omiten; LinksInNewWindow añade la protección noopener noreferrer y las ScreenTips se convierten en títulos SVG

Salida incremental de PNG, JPEG y TIFF multipágina

TXLSPageImageFormat selecciona la salida PNG o JPEG y TXLSPageImageExporter mantiene viva una sesión de paginación mientras libera rápidamente cada mapa de bits completado

PDF etiquetado y PDF/A

TXLSPDFExport.TagMode habilita la estructura automática de documento, tabla, fila, celda de encabezado, celda de datos e imagen informativa, con identificadores de contenido marcado densos y locales a la página, mapeos exactos del árbol de padres, spans de celdas combinadas y aislamiento de artifacts; las filas de títulos de impresión y las filas de encabezado de tabla se convierten en celdas de encabezado semánticas, las imágenes XLSX con AltText no vacío se convierten en elementos Figure independientes con texto alternativo Unicode, y las imágenes sin texto alternativo permanecen como artifacts decorativos

Cada instancia visible de imagen informativa recibe su propio elemento Figure e identificador de contenido marcado aunque payloads de imagen iguales compartan un XObject de PDF; AltTextTitle no reemplaza el texto alternativo ausente, los gráficos permanecen como artifacts, y este soporte de estructura enfocada no reclama conformidad completa con PDF/UA

TXLSPDFExport.PDFAProfile selecciona PDF/A-1, PDF/A-2 o PDF/A-3 en el nivel de conformidad a o b; el cifrado, las fuentes, los adjuntos, la transparencia, las firmas y los metadatos incompatibles se validan antes de confirmar el flujo de salida

TXLSPDFExport.ExportCommentsAsAnnotations coloca el autor Unicode y el texto del comentario en los rectángulos de las celdas de origen, mientras que la salida tradicional de comentarios al final sigue siendo configurable de forma independiente

UsePDFA es el interruptor de compatibilidad para PDF/A-1b, mientras que UseXRefStream selecciona flujos de referencia cruzada donde el perfil elegido lo permite

Geometría y selección de página

Las seis sobrecargas de CalculatePageCount aceptan rangos clásicos y XLSX, hojas de cálculo o libros sin crear objetos PDF

PaperWidth y PaperHeight anulan las dimensiones del papel en puntos, LastPage cierra el intervalo de salida basado en uno, Orientation (tipo TXLSPDFOrientation) selecciona salida vertical u horizontal, HidePrintObjects (un conjunto de TXLSPDFHidePrintObject: xlsPdfHideHeaders, xlsPdfHideFooters) suprime bandas seleccionadas de encabezado o pie, y PageLayout (tipo TXLSPDFPageLayout) establece la disposición inicial de páginas del visor

Modo de página y acción de apertura del PDF

TXLSPDFExport.PageMode (tipo TXLSPDFPageMode) establece cómo un visor PDF organiza los paneles al abrir el documento, mediante xlsPdfModeDefault, xlsPdfModeUseOutlines, xlsPdfModeUseThumbs, xlsPdfModeFullScreen, xlsPdfModeUseOCy xlsPdfModeUseAttachments

OpenAction (tipo TXLSPDFOpenAction) selecciona el comportamiento inicial del visor con xlsPdfOpenNone, xlsPdfOpenPageo xlsPdfOpenOutlines. Para xlsPdfOpenPage, OpenActionPage es la página objetivo basada en uno (acotada al número de páginas) y OpenActionZoom es el factor de aumento inicial, donde 0 conserva el zoom por defecto del visor o el ajuste a la página

Geometría vectorial adaptativa compartida

XLSBuildEllipticArcCubics convierte un arco elíptico en segmentos cúbicos Bezier imponiendo recursivamente un límite de planitud seleccionado por el llamador; el renderizado PDF, SVG y de mapa de bits usa esta geometría compartida, de modo que los arcos grandes o muy excéntricos reciben más segmentos sin penalizar los arcos simples

XLSDecodeVectorScene valida cabeceras EMF y WMF, alineación y tamaños de registros, totales declarados, colocación exacta del EOF y límites de recursos sin invocar la reproducción de metafiles de la plataforma; la lista blanca nativa reproduce pilas de estado de contextos de dispositivo con save y restore, mapeo de ventana y viewport combinado con transformaciones de mundo, tablas de objetos de pluma, brocha y pluma extendida incluyendo stock objects, rectángulos, elipses, cadenas de líneas, polígonos, polilíneas y curvas Bézier con estilos de guion, brackets de path con pasadas de relleno, trazo y trazo y relleno combinados, rectángulos redondeados, arcos, cuerdas, sectores y arcos angulares mediante conversión exacta de arco a Bézier, rellenos y marcos de regiones a partir de rectángulos RGNDATA acotados, runs de texto acotados con fuentes, colores y alineación, e imágenes stretch-DIB restringidas recodificadas como PNG a través de Canvas y SVG; rechaza los registros de escape y deja el recorte y los registros privados en el fallback acotado existente

Marcadores de PDF y callbacks de página

Los marcadores de PDF viven en la colección Bookmarks (tipo TXLSPDFBookmarks): Add y AddForSheet añaden entradas, Delete elimina una, y Count con Items enumera el árbol. Cada entrada TXLSPDFBookmark admite entradas padre e hijas (Children), cadenas de hermanos, títulos Unicode, colores (Color), un destino PageNumber , el SheetName de origen para marcadores de hojas de cálculo, y flags de negrita o cursiva (conjunto de TXLSPDFBookmarkStyle: xlsPdfBookmarkBold, xlsPdfBookmarkItalic), más descendientes expandidos o contraídos; los marcadores automáticos de hojas de cálculo usan el mismo modelo de jerarquía y AutoSheetBookmarks activa o desactiva su generación

BeforeNewPage puede ajustar la caja de cada página, mientras que BeforeGeneratePage y AfterGeneratePage dibujan contenido de fondo o superposición mediante los helpers públicos de página AppendPageContent, FillPageRectangle, StrokePageRectangley DrawPageText

Firmas y adjuntos

TXLSPDFSignature configura campos de firma visibles o invisibles, mientras que CertificationPolicy crea opcionalmente una firma de certificación DocMDP que puede no permitir cambios, permitir rellenar formularios y firmar, o permitir rellenar formularios, firmar y anotar; PDF/A-1 no permite esta característica de PDF 1.5 y se rechaza antes de confirmar la salida

TXLSPDFCertificationPolicy proporciona xlsPdfApprovalSignature, xlsPdfCertifyNoChanges, xlsPdfCertifyFormFillingAndSigningy xlsPdfCertifyFormFillingSigningAndAnnotations para seleccionar la política de firma explícitamente

Un TXLSPDFSignDigestEvent recibe el resumen y devuelve datos CMS creados por el host, de modo que HotXLS nunca necesita una clave privada

TXLSPDFExport.Signature adjunta la configuración de firma y los perfiles PDF/A-3 pueden incluir archivos asociados validados mediante AddAttachment, que encola un TXLSPDFAttachment; la sobrecarga detallada acepta un nombre visible Unicode, tipo MIME, descripción, fecha de modificación, payload y un valor TXLSPDFAttachmentRelationship de Source, Data, Alternative, Supplement o Unspecified, mientras que AttachmentCount informa del total en cola y AttachmentDuplicatePolicy (tipo TXLSPDFAttachmentDuplicatePolicy) selecciona cómo se manejan los nombres iguales

TXLSPDFSignature.ImageData, ImageFormate ImageFit (tipo TXLSPDFSignatureImageFit: contain, cover o stretch) colocan un PNG en el Form de apariencia normal antes de que el byte range se congele; los modos contain, cover y stretch comparten la caché de imágenes del documento, mientras que las imágenes no válidas fallan antes de firmar

La sobrecarga IXLSPDFAttachmentSource permanece lazy hasta el guardado, invoca cada fuente una vez por guardado y vuelca a un spool de como máximo 256 MiB antes de crear el objeto EmbeddedFile, de modo que los fallos del proveedor dejan la transacción del destino intacta

El ensamblado final escribe los objetos secuencialmente en el destino en lugar de construir una única cadena de todo el documento: las exportaciones sin firmar fluyen directamente a streams de solo avance, cada EmbeddedFile referencia su tamaño en bytes mediante un objeto indirecto /Length emitido después del payload, y los bytes del proveedor se copian del spool en bloques fijos; las exportaciones firmadas se ensamblan en un spool de documento acotado que recibe los parches de ByteRange y contenidos de firma, un SHA-256 incremental sobre los dos rangos cubiertos y una única copia hacia adelante

La salida PDF/A-3 escribe cada archivo asociado tanto en el árbol de nombres EmbeddedFiles como en el array AF del catálogo, con un nombre Unicode UF , un PDF Name MIME escapado, AFRelationship, tamaño en bytes, fecha de modificación opcional y descripción opcional; PDF/A-1 y PDF/A-2 rechazan los adjuntos en cola antes de confirmar la salida

Metadatos del documento

DocumentTitle, DocumentAuthor, DocumentSubject, DocumentKeywordsy DocumentFileName completan los diccionarios de información y metadatos del PDF

Sustitución de fuentes

TXLSPDFExport.SetFontFallbackChain, AddFontFallbacky ClearFontFallbackChains configuran niveles de fallback según la familia de origen y el estilo; LoadedFallbackFontCount expone el número de caras en caché y FontFallbackSelectionCacheCount el número de decisiones de fallback por selección cacheadas, ambos para diagnósticos

TXLSPDFExport.FontSize establece el tamaño de texto por defecto en puntos, con 9 como valor por defecto

La selección de sustitución usa la cobertura de glifos y conserva las asignaciones Unicode, los escalares suplementarios, los clústeres de grafemas, los clústeres de conformación y las caras TTC independientes

OnGetFontDirectories puede devolver uno o más directorios de fuentes separados por punto y coma para una familia y estilo solicitados; los directorios aceptados se buscan recursivamente una sola vez, se indexan por metadatos internos de familia/estilo y se cachean para las mediciones y dibujos posteriores

Política de incrustación de fuentes

TXLSPDFExport.FontEmbedding (tipo TXLSPDFFontEmbedding) selecciona incrustación automática, subsetting obligatorio, el programa de fuente completo o salida de solo mapa mediante xlsPdfFontEmbedAuto, xlsPdfFontEmbedSubset, xlsPdfFontEmbedFully xlsPdfFontEmbedNone; el subsetting obligatorio falla atómicamente cuando no se puede producir un subconjunto válido, las caras TTC se convierten en fuentes independientes, y PDF/A rechaza la salida de solo mapa

OnFontEmbed se dispara una vez por cara Unicode antes de resolver sus métricas, mapa de caracteres, shaping e identificadores de glifo; establecer Handled acepta el modo devuelto por fuente y los bytes de reemplazo opcionales, mientras que dejarlo en False conserva la política del documento y la cara original

Las fuentes OpenType independientes con outlines CFF se incrustan mediante FontFile3 con un stream OpenType y un descendiente CIDFontType0 ; los modos automático y completo retienen el programa completo, mientras que el subsetting CFF obligatorio falla atómicamente porque no puede preservar un subconjunto válido

Las fuentes incrustadas que llevan datos GPOS de OpenType o kern heredado usan avances de glifo posicionados para texto simple y complejo, de modo que la medición, el ajuste de línea, la alineación y las posiciones de glifo emitidas comparten el mismo resultado de kerning

Progreso y cancelación

TXLSPDFExport.OnProgress y OnProgressEx informan de las fases de inicio, página y fin; Cancel solicita la cancelación y Aborted informa del estado final sin confirmar un flujo parcial

Véase también

• TXLSPaginationModel
• SaveAsPDF
• Flujos de trabajo avanzados de libros