Renderizado y exportación avanzados

Las rutas de PDF, SVG, mapa de bits, metarchivo, vista previa e impresión comparten un único modelo de paginación y una geometría independiente del backend, conservando codificadores específicos de cada formato

Backends gráficos personalizados

TXLSGraphicsTextAlign define la alineación de texto izquierda, centrada y derecha para TXLSGraphicsBackend; las llamadas de dibujo con estilos reciben los enums compartidos restantes — 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, efectos de texto e imagen resueltos, recortes y colocación de dibujo local de página, sin necesidad de repetir la lógica de diseño del libro de trabajo. Cada dibujo de una página 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 propiedad de la operación

TXLSPaginationModel.RenderBackend selecciona la identidad de backend que captura la siguiente llamada a Build , y RenderGeometry expone la calibración inmutable resultante, la generación del libro de trabajo, el backend y el estado acotado de la caché de métricas; la sesión de renderizado activa viaja como un manejador 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, la impresión y las vistas previas de impresión usan xlsrgbPrintPreview, y TXLSWorkbookViewer usa xlsrgbViewer; PaginationModel en los componentes SVG, de imagen, de impresión y del visor expone el modelo activo para diagnósticos sin transferir la propiedad

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

La salida de columnas HTML convierte el modelo de ancho de caracteres del libro de trabajo a través del ancho máximo 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 de puntos y píxeles usa el mismo DPI de medición capturado

Cada operación conserva su calibración capturada incluso si el libro de trabajo cambia después, y el renderizado nunca escribe altos de fila ni anchos de columna de la hoja de cálculo. La paginación construye las 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 callback necesita: identidad (DocumentPageNumber, SheetPageNumber, SheetName, la ClassicWorksheet o XlsxWorksheetpropietaria), geometría (PageWidth, PageHeight, Scale, y 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), colocación del fondo (BackgroundOffsetX, BackgroundOffsetY), salida de líneas de cuadrícula (PrintGridlines, GridlineColor), los seis textos de las 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 el tamaño de punto y el color iniciales para que los pintores personalizados igualen el renderizado de encabezados propio de 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 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 explícitos del borde exterior permanecen visibles y los bordes internos de la combinación se suprimen; los fragmentos Classic comparten el texto y el relleno sólido del ancla a través del pintor de texto Classic existente

Un área de impresión o un salto de página puede 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 contribuyen con 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 de trabajo muestra los fondos de hoja válidos de Classic y XLSX como mosaicos repetidos detrás de las celdas sin relleno, mientras que los rellenos de celda explícitos y condicionales permanecen por encima del fondo

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

La salida paginada habilitada ancla la fase de mosaicos 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 recurso, backend, DPI y modo de color durante la sesión de renderizado; BackgroundDecodeCount expone el total de decodificaciones para diagnósticos, mientras que las cargas útiles corruptas se omiten con un diagnóstico del libro de trabajo. La TXLSRenderSession activa gestiona esa caché compartida por sí misma: AcquireBackground obtiene (o decodifica una vez) el TXLSSheetBackgroundRenderData en mosaico de una hoja de cálculo, DrawTiledBackground lo pinta en una región de página recortada, y DecodeCount informa cuántas cargas útiles se han decodificado hasta el momento

Política de visualización de objetos del libro de trabajo

ObjectDisplayMode selecciona xlsodmShowAll, xlsodmShowPlaceholderso xlsodmHideAll tanto para libros de trabajo Classic XLS como XLSX; el visor consume los tres estados y usa cuadros de bajo costo con tipo, nombre, texto y texto alternativo para el modo de marcadores de posición

Los exportadores de PDF, SVG, mapa de bits, impresión física y HTML XLSX tratan el modo de marcadores de posición como salida de objetos completos de forma predeterminada; asigne ExportObjectPlaceholders en el exportador o en las opciones HTML correspondientes para pedir cuadros sin decodificar imágenes ni construir escenas de gráficos

xlsodmHideAll es una barrera global temprana que evita la recolección de dibujos, la expansión de rangos impulsada por objetos, las pruebas de impacto 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 objetos de impresión específicos de cada exportador permanecen independientes

Actualización de 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 trabajo, de modo que las ediciones de celdas de origen, el recálculo y los cambios de visibilidad refrescan valores, categorías, tamaños de bubble y nombres de series vinculados a rangos antes de la salida

Los rangos de origen ordinarios deben ser una sola fila o columna de referencias A1 locales; se soportan los nombres de hojas entrecomillados, y un rango sin calificar se resuelve contra la hoja propietaria del gráfico; los niveles jerárquicos de categorías retienen su resolvedor separado de rangos rectangulares

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

Las cachés importadas o pobladas manualmente se retienen cuando una fuente local nunca se ha materializado, mientras que las cachés ya administradas desde celdas locales limpian los puntos obsoletos después de la eliminación; TXLSXChartSeries.RefreshDataCaches refresca explícitamente las fuentes locales resolubles, incluido un rango de origen vacío

Las referencias a libros externos y las expresiones de referencia no soportadas retienen sus cachés almacenadas; el refresh de cachés no abre archivos externos ni realiza solicitudes de red

Ejes de fechas de gráficos conscientes del calendario

TXLSXChartSeries.ResolveDataCaches resuelve las fuentes locales de series soportadas para la generación actual, y RefreshDataCaches solicita un refresh explícito incluso cuando una fuente vacía 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 de trabajo y conservan la distancia real entre fechas dispersas, en lugar de asignar ranuras de puntos iguales

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

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

Escritor PDF independiente

TXLSPDFWriter crea documentos PDF que no se originan en un libro de trabajo, como facturas, boletos, etiquetas y formularios de superposición; BeginDoc establece un cuadro de página preciso en 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 trazados, líneas, elipses, texto con estilos y medición exacta de ancho, transformaciones afines, recorte rectangular y guardado o restauración explícita del estado de gráficos, mientras que PageWidth y PageHeight informan el cuadro de página actual en puntos

Exportación SVG

TXLSSvgExport proporciona siete sobrecargas de SaveAsSVG para rangos, hojas de cálculo y libros de trabajo Classic y XLSX, y páginas lógicas preparadas, además de salida de objetos con nombre donde está soportada

UseWorksheetPageSetup, Orientationy Margin usan las mismas decisiones de configuración de página que las salidas 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 agrega un listado 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 a la vez a través de OnPage, informa el número de páginas confirmadas mediante ExportedPageCount, y se detiene antes de generar páginas posteriores cuando el callback cancela; IdPrefix crea espacios de nombres deterministas de documento y de página para rutas de recorte, filtros, patrones y recursos compartidos

HyperlinkMode (tipo TXLSSvgHyperlinkMode) con xshmSafe agrega regiones de impacto transparentes 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 agrega la protección noopener noreferrer y las ScreenTips se convierten en títulos SVG

Salida incremental 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 con rapidez 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 densos de contenido marcado locales de página, mapeos exactos del árbol de padres, tramos de celdas combinadas y aislamiento de artefactos; 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 artefactos decorativos

Cada instancia de imagen informativa visible recibe su propio elemento Figure e identificador de contenido marcado, incluso cuando cargas útiles de imagen iguales comparten un XObject de PDF; AltTextTitle no reemplaza el texto alternativo faltante, los gráficos permanecen como artefactos, y este soporte de estructura enfocada no afirma conformidad completa con PDF/UA

TXLSPDFExport.PDFAProfile selecciona PDF/A-1, PDF/A-2 o PDF/A-3 en 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 y el texto de comentario Unicode sobre 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 los permite

Geometría y selección de páginas

Las seis sobrecargas de CalculatePageCount aceptan rangos, hojas de cálculo o libros de trabajo Classic y XLSX sin construir objetos PDF

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

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

TXLSPDFExport.PageMode (tipo TXLSPDFPageMode) establece cómo organiza los paneles un visor PDF 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 de destino de base 1 (acotada al número de páginas) y OpenActionZoom es el factor de aumento inicial, donde 0 conserva el zoom o ajuste predeterminado del visor

Geometría vectorial adaptativa compartida

XLSBuildEllipticArcCubics convierte un arco elíptico en segmentos Bézier cúbicos aplicando recursivamente un límite de planitud elegido 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 encabezados EMF y WMF, alineación y tamaños de registros, totales declarados, colocación exacta de EOF y límites de recursos, sin invocar la reproducción de metarchivos de la plataforma; la lista blanca nativa reproduce pilas de estado de contexto de dispositivo con guardar y restaurar, mapeo de ventana y viewport combinado con transformaciones de mundo, tablas de objetos de pluma, pincel y pluma extendida incluidos los objetos de stock, rectángulos, elipses, cadenas de líneas, polígonos, polilíneas y curvas Bézier con estilos de guión, corchetes de ruta con pasos de relleno, trazado y combinado, rectángulos redondeados, arcos, cuerdas, sectores y arcos angulares mediante conversión exacta de arco a Bézier, rellenos y marcos de región a partir de rectángulos RGNDATA acotados, tramos 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 al respaldo acotado existente

Esquemas PDF y callbacks de página

Los esquemas PDF viven en la colección Bookmarks (tipo TXLSPDFBookmarks): Add y AddForSheet agregan entradas, Delete elimina una, y Count con Items enumera el árbol. Cada entrada TXLSPDFBookmark soporta entradas padre e hijas (Children), cadenas de hermanos, títulos Unicode, colores (Color), un destino PageNumber , el SheetName de origen para los 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 conmuta su generación

BeforeNewPage puede ajustar el cuadro de cada página, mientras que BeforeGeneratePage y AfterGeneratePage dibujan contenido de fondo o superposición a través de los asistentes públicos de página AppendPageContent, FillPageRectangle, StrokePageRectangley DrawPageText

Firmas y archivos adjuntos

TXLSPDFSignature configura campos de firma visibles o invisibles, mientras que CertificationPolicy crea opcionalmente una firma de certificación DocMDP que permite sin cambios, llenado y firma de formularios, o llenado, firma y anotaciones de formularios; 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 para mostrar Unicode, tipo MIME, descripción, hora de modificación, carga útil y un valor TXLSPDFAttachmentRelationship de Source, Data, Alternative, Supplement o Unspecified, mientras que AttachmentCount informa el 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 congelar el rango de bytes; 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 diferida hasta guardar, invoca cada origen una vez por guardado, y spolea como máximo 256 MiB antes de crear el objeto EmbeddedFile, de modo que los fallos del proveedor dejan la transacción del destino sin cambios

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 flujos de solo avance, cada EmbeddedFile referencia su tamaño en bytes mediante un objeto indirecto /Length emitido después de la carga útil, 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 del contenido de la 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 arreglo AF del catálogo, con un nombre UF Unicode, un PDF Name de MIME con escape, 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 de documento

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

Fallback de fuentes

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

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

La selección de fallback usa cobertura de glifos y preserva mapeos Unicode, escalares suplementarios, clústeres de grafemas, clústeres de conformación y 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 registran recursivamente una sola vez, se indexan por metadatos internos de familia/estilo, y se guardan en caché para mediciones y dibujos posteriores

Política de incrustación de fuentes

TXLSPDFExport.FontEmbedding (tipo TXLSPDFFontEmbedding) selecciona incrustación automática, subconjunto requerido, el programa completo de la fuente o salida solo de mapeo mediante xlsPdfFontEmbedAuto, xlsPdfFontEmbedSubset, xlsPdfFontEmbedFully xlsPdfFontEmbedNone; el subconjunto requerido 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 solo de mapeo

OnFontEmbed se dispara una vez por cara Unicode antes de resolver sus métricas, mapa de caracteres, conformación e identificadores de glifos; asignar Handled acepta el modo por fuente devuelto y los bytes de reemplazo opcionales, mientras que dejarlo en falso retiene la política del documento y la cara original

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

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

Progreso y cancelación

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

Ver también

• TXLSPaginationModel
• SaveAsPDF
• Flujos de trabajo avanzados de libros