Processamento avançado e exportação

Os caminhos PDF, SVG, bitmap, metaficheiro, pré-visualização e impressão partilham um modelo de paginação e uma geometria neutra relativamente ao backend, mantendo codificadores específicos de cada formato

Backends gráficos personalizados

TXLSGraphicsTextAlign define o alinhamento de texto à esquerda, ao centro e à direita para TXLSGraphicsBackend; as chamadas de desenho estilizado recebem os restantes enums partilhados — estilos de tipo de letra (TXLSGraphicsFontStyles), terminações de linha (TXLSGraphicsLineCap), padrões de tracejado (TXLSGraphicsLineDash) e alinhamento vertical de texto (TXLSGraphicsTextVAlign)

As implementações recebem coordenadas em pontos, efeitos de texto e de imagem resolvidos, recorte e posicionamento de desenho local à página, sem necessidade de repetir a lógica de disposição do livro de trabalho. Cada desenho numa página lógica chega como um registo TXLSPageDrawingPlacement cujo Kind (TXLSPageDrawingKind: xpdkImage, xpdkChart, xpdkTextBox, xpdkShape, xpdkControl) indica ao backend o que está a pintar; os mosaicos do fundo da folha de cálculo chegam como TXLSSheetBackgroundRenderData

Geometria de renderização pertencente à operação

TXLSPaginationModel.RenderBackend seleciona a identidade do backend capturada pela próxima chamada a Build , e RenderGeometry expõe a calibração imutável resultante, a geração do livro de trabalho, o backend e o estado limitado da cache de métricas; a sessão de renderização ativa circula como um handle TXLSRenderSession e a política de cores é um TXLSRenderColorMode (xlsrcColor ou xlsrcMonochrome)

Os modelos PDF utilizam xlsrgbPdf, o SVG utiliza xlsrgbSvg, as imagens de página utilizam xlsrgbBitmap, os modelos de impressão e de pré-visualização de impressão utilizam xlsrgbPrintPreview, e o TXLSWorkbookViewer utiliza xlsrgbViewer; PaginationModel nos componentes SVG, de imagem, de impressão e de visualização expõe o modelo ativo para diagnóstico sem transferir a propriedade

Os pontos de entrada HTML clássicos e XLSX capturam xlsrgbHtml; TXLSHTMLExport.RenderGeometry expõe o instantâneo clássico mais recente, enquanto TXLSXHtmlExportSession.RenderGeometry expõe o instantâneo retido em todas as folhas numa exportação incremental

A saída de colunas HTML converte o modelo de largura de caracteres do livro de trabalho através da largura máxima de dígito do tipo de letra Normal e da escala de ecrã configurada antes de emitir um comprimento fixo em píxeis CSS; a conversão entre pontos e píxeis utiliza o mesmo DPI de medição capturado

Cada operação retém a calibração capturada mesmo que o livro de trabalho mude mais tarde, e a renderização nunca escreve alturas de linha nem larguras de coluna da folha de cálculo. A paginação constrói páginas a partir de objetos TXLSLogicalPage cujos desenhos, orientação (TXLSPageOrientation: xpoPortrait ou xpoLandscape) e colocação de comentários (TXLSPrintComments: xpcNone ou xpcAtEnd) vêm da configuração de página resolvida

Uma página lógica expõe tudo o que um backend ou callback precisa: identidade (DocumentPageNumber, SheetPageNumber, SheetName, a ClassicWorksheet ou XlsxWorksheetproprietária), geometria (PageWidth, PageHeight, Scalee os valores LeftMargin, RightMargin, TopMargin, BottomMargin, HeaderMargine FooterMargin ), o retângulo de dados (DataFirstRow, DataLastRow, DataFirstCol, DataLastCol) com títulos de impressão (RepeatFirstRow, RepeatLastRow, RepeatFirstCol, RepeatLastCol), colocação do fundo (BackgroundOffsetX, BackgroundOffsetY), saída de linhas de grelha (PrintGridlines, GridlineColor), os seis textos das bandas de cabeçalho e rodapé (LeftHeader, CenterHeader, RightHeader, LeftFooter, CenterFooter, RightFooter) e os esqueletos de linhas e colunas da página (RowCount com Rows e RowEdges, ColumnCount com Columns e ColumnEdges), mais a lista de desenhos (DrawingCount e Drawings). ExpandHeaderFooter resolve os códigos de formato de cabeçalho e rodapé contra a página, e ExpandHeaderFooterStyled informa adicionalmente o tamanho de ponto inicial e a cor, para que pintores personalizados possam igualar a renderização de cabeçalho do próprio Excel

Células mescladas na paginação nativa

O TXLSPaginationModel.RenderPageToBackend resolve um intervalo mesclado até à sua âncora original e pinta um retângulo visível por fragmento de página; as células cobertas não emitem texto duplicado nem linhas de grelha internas

Os fragmentos XLSX partilham o preenchimento, o alinhamento, o wrapping, o tipo de letra e a avaliação de formato condicional da âncora, enquanto os segmentos de borda exteriores explícitos continuam visíveis e as bordas internas da mesclagem são suprimidas; os fragmentos Classic partilham o texto e o preenchimento sólido da âncora através do pintor de texto Classic existente

Uma área de impressão ou uma quebra de página pode recortar um intervalo mesclado, e cada fragmento visível usa a âncora original mesmo quando esta está fora da área de impressão; linhas e colunas ocultas contribuem com extensão zero, e os fragmentos repetidos de títulos de impressão usam a mesma política de âncora

A mesclagem não força um intervalo para uma única página, não expande a área de impressão e não altera as alturas de linha nem as larguras de coluna armazenadas; a paginação mantém a configuração de página existente e recorta cada fragmento à respetiva página lógica

Renderização do fundo da folha de cálculo

O visualizador do livro de trabalho apresenta fundos válidos de folhas de cálculo clássicas e XLSX como mosaicos repetidos atrás das células sem preenchimento, enquanto os preenchimentos explícitos e condicionais das células permanecem acima do fundo

TXLSPaginationModel, TXLSSvgExport, TXLSPageImageExporter, TXLSPrintDocument, TXLSPDFExport, TXLSHTMLExport, TXLSXHtmlExportOptionse TXLSWorkbookViewer expõem ExportSheetBackgroundImages; a predefinição é False para saída de impressão, pré-visualização, metaficheiro, PDF, SVG, bitmap e HTML. As folhas de cálculo guardam o seu payload com um formato de imagem TXLSSheetBackgroundFormat , e os bytes descodificados viajam como um TXLSSheetBackgroundResource chaveado por geração, DPI e modo de cor

A saída paginada ativada ancora a fase de mosaicos às coordenadas da folha de cálculo através dos limites das páginas e retém uma imagem descodificada por folha de cálculo, geração de recursos, backend, DPI e modo de cor durante a sessão de renderização; BackgroundDecodeCount expõe o total de descodificações para diagnóstico, enquanto os payloads corrompidos são ignorados com um diagnóstico do livro de trabalho. A TXLSRenderSession ativa gere essa cache partilhada por si própria: AcquireBackground obtém (ou descodifica uma única vez) os TXLSSheetBackgroundRenderData em mosaico de uma folha de cálculo, DrawTiledBackground pinta-os numa região recortada da página, e DecodeCount informa quantos payloads foram descodificados até ao momento

Política de apresentação de objetos do livro de trabalho

ObjectDisplayMode seleciona xlsodmShowAll, xlsodmShowPlaceholdersou xlsodmHideAll tanto em livros de trabalho Classic XLS como XLSX; o visualizador consome os três estados e utiliza caixas de baixo custo com tipo, nome, texto e texto alternativo para o modo de marcadores de posição

Os exportadores PDF, SVG, bitmap, de impressão física e HTML XLSX tratam o modo de marcadores de posição como saída de objetos completos por predefinição; defina ExportObjectPlaceholders no exportador ou nas opções HTML correspondentes para pedir caixas sem descodificação de imagens nem construção de cenas de gráficos

xlsodmHideAll é um bloqueio global anterior que impede a recolha de desenhos, a expansão de intervalos orientada por objetos, o hit testing e a renderização de media; os fundos de folhas de cálculo, os ícones de formatação condicional, as imagens de cabeçalho ou rodapé, as células e os filtros de impressão de objetos específicos do exportador permanecem independentes

Atualização dos dados de origem dos gráficos

A serialização de gráficos XLSX e a renderização de gráficos partilhada resolvem as caches de séries locais contra a geração atual do livro de trabalho, pelo que as edições de células de origem, o recálculo e as alterações de visibilidade atualizam valores, categorias, tamanhos de bolha e nomes de séries ligados a intervalos antes da saída

Os intervalos de origem ordinários têm de ser uma única linha ou coluna de referências A1 locais; os nomes de folhas de cálculo entre plicas são suportados, e um intervalo não qualificado resolve-se contra a folha de cálculo proprietária do gráfico; os níveis hierárquicos de categorias mantêm o respetivo resolvedor separado de intervalos retangulares

O texto de categorias usa o texto formatado da célula, as caches numéricas mantêm posições vazias para vazios e texto não numérico, as células de erro mantêm os respetivos literais de erro exibidos, e as datas usam o sistema serial 1900 ou 1904 do livro de trabalho; o PlotVisibleOnly determina se as linhas e colunas de origem ocultas são omitidas

As caches importadas ou preenchidas manualmente são retidas quando uma origem local nunca foi materializada, enquanto as caches já geridas a partir de células locais limpam as posições obsoletas após eliminações; o TXLSXChartSeries.RefreshDataCaches atualiza explicitamente as origens locais resolvíveis, incluindo um intervalo de origem vazio

As referências a livros externos e as expressões de referência não suportadas mantêm as respetivas caches armazenadas; a atualização de caches não abre ficheiros externos nem faz pedidos de rede

Eixos de datas de gráficos com noção de calendário

O TXLSXChartSeries.ResolveDataCaches resolve as origens de séries locais suportadas para a geração atual, e o RefreshDataCaches pede uma atualização explícita mesmo quando uma origem vazia não tem histórico de células

Os gráficos XLSX cujo eixo de categorias utiliza xlsxAxisDate mapeiam cada categoria válida através do sistema de datas seriais 1900 ou 1904 do livro de trabalho e retêm a distância real entre datas esparsas em vez de atribuir intervalos de pontos iguais

BaseTimeUnit controla a normalização por dia, mês ou ano, enquanto MajorUnit, MinorUnit, MajorTimeUnite MinorTimeUnit avançam os marcadores por unidades de calendário; os intervalos de meses e anos mantêm-se assim alinhados entre durações de meses desiguais e anos bissextos

A mesma coleção limitada de marcadores fornece coordenadas, rótulos, marcas e as linhas de grelha pedidas à saída de PDF, SVG, bitmap, pré-visualização, impressão e visualização baseada em paginação, enquanto o HTML XLSX utiliza a aritmética de calendário partilhada no SVG inline dos seus gráficos

Escritor PDF autónomo

TXLSPDFWriter cria documentos PDF que não têm origem num livro de trabalho, como faturas, bilhetes, etiquetas e formulários de sobreposição; BeginDoc define uma caixa de página com precisão de pontos, NewPage fecha a página atual, e SaveToStream ou SaveToFile conclui o documento

Os métodos de desenho utilizam pontos PDF a partir do canto inferior esquerdo e cores da biblioteca na forma $00BBGGRR ou $AABBGGRR ; as primitivas disponíveis cobrem FillRectangle, StrokeRectangle, ClipRectangle, MeasureText, SaveGraphicsStatee RestoreGraphicsState para retângulos preenchidos e contornados, linhas, elipses, texto estilizado com medição exata de largura, transformações afins, recorte retangular e gravação ou reposição explícita do estado gráfico, enquanto PageWidth e PageHeight informam a caixa de página atual em pontos

Exportação SVG

TXLSSvgExport fornece sete sobrecargas de SaveAsSVG para intervalos clássicos e XLSX, folhas de cálculo, livros de trabalho e páginas lógicas preparadas, além de saída com objetos nomeados onde é suportada

UseWorksheetPageSetup, Orientatione Margin utilizam as mesmas decisões de configuração de página que a saída PDF e de pré-visualização

TXLSSvgExport.PrintComments (tipo TXLSPrintComments) seleciona como os comentários de células são emitidos na saída SVG paginada; quando definido como xpcAtEnd, a última página da folha acrescenta uma lista de comentários (endereço da célula, autor e texto) abaixo da área de dados, enquanto xpcNone omite os comentários

ExportPages envia um documento SVG completo de cada vez através de OnPage, comunica a contagem de páginas comprometidas através de ExportedPageCounte para antes de gerar páginas posteriores quando o callback cancela; IdPrefix cria namespaces de documento e de página determinísticos para clip paths, filtros, padrões e recursos partilhados

HyperlinkMode (tipo TXLSSvgHyperlinkMode) com xshmSafe acrescenta regiões de deteção transparentes recortadas após o conteúdo visual; os esquemas externos permitidos são HTTP, HTTPS, mail, FTP e ligações relativas, enquanto os destinos ativos, locais, UNC e com caracteres de controlo são omitidos; LinksInNewWindow acrescenta a proteção noopener noreferrer e as ScreenTips passam a títulos SVG

Saída incremental em PNG, JPEG e TIFF multipágina

TXLSPageImageFormat seleciona a saída PNG ou JPEG e TXLSPageImageExporter mantém uma sessão de paginação ativa enquanto liberta prontamente cada bitmap concluído

PDF com etiquetas e PDF/A

TXLSPDFExport.TagMode ativa a estrutura automática de documento, tabela, linha, célula de cabeçalho, célula de dados e imagem informativa, com identificadores densos de conteúdo marcado locais à página, mapeamentos exatos da árvore de pais, intervalos de células unidas e isolamento de artefactos; as linhas de títulos de impressão e as linhas de cabeçalho de tabelas tornam-se células de cabeçalho semânticas, as imagens XLSX com AltText não vazio tornam-se elementos Figure independentes com texto alternativo Unicode, e as imagens sem texto alternativo permanecem artefactos decorativos

Cada instância visível de imagem informativa recebe o seu próprio elemento Figure e identificador de conteúdo marcado, mesmo quando payloads de imagem iguais partilham um XObject PDF; AltTextTitle não substitui o texto alternativo em falta, os gráficos permanecem artefactos, e este suporte de estrutura focada não reivindica conformidade PDF/UA completa

TXLSPDFExport.PDFAProfile seleciona PDF/A-1, PDF/A-2 ou PDF/A-3 no nível de conformidade a ou b; encriptação, tipos de letra, anexos, transparência, assinaturas e metadados incompatíveis são validados antes de o fluxo de saída ser confirmado

TXLSPDFExport.ExportCommentsAsAnnotations coloca o texto Unicode de autor e comentário nos retângulos das células de origem, enquanto a saída tradicional de comentários no fim permanece configurável de forma independente

UsePDFA é o comutador de compatibilidade para PDF/A-1b, enquanto UseXRefStream seleciona fluxos de referência cruzada onde o perfil escolhido os permite

Geometria e seleção de páginas

As seis sobrecargas de CalculatePageCount aceitam intervalos clássicos e XLSX, folhas de cálculo ou livros de trabalho sem criar objetos PDF

PaperWidth e PaperHeight substituem as dimensões do papel em pontos, LastPage fecha o intervalo de saída com base um, Orientation (tipo TXLSPDFOrientation) seleciona a saída vertical ou horizontal, HidePrintObjects (um conjunto de TXLSPDFHidePrintObject: xlsPdfHideHeaders, xlsPdfHideFooters) suprime bandas de cabeçalho ou rodapé selecionadas, e PageLayout (tipo TXLSPDFPageLayout) define a disposição inicial da página no visualizador

Modo de página PDF e ação de abertura

TXLSPDFExport.PageMode (tipo TXLSPDFPageMode) define como um visualizador PDF organiza os painéis quando o documento abre, através de xlsPdfModeDefault, xlsPdfModeUseOutlines, xlsPdfModeUseThumbs, xlsPdfModeFullScreen, xlsPdfModeUseOCe xlsPdfModeUseAttachments

OpenAction (tipo TXLSPDFOpenAction) seleciona o comportamento inicial do visualizador com xlsPdfOpenNone, xlsPdfOpenPageou xlsPdfOpenOutlines. Para xlsPdfOpenPage, OpenActionPage é a página de destino com base um (saturada ao número de páginas) e OpenActionZoom é o fator de ampliação inicial, em que 0 mantém o zoom predefinido do visualizador ou o ajuste à página

Geometria vetorial adaptativa partilhada

XLSBuildEllipticArcCubics converte um arco elíptico em segmentos cúbicos de Bezier impondo recursivamente um limite de achatamento escolhido pelo chamador; a renderização PDF, SVG e bitmap utiliza esta geometria partilhada, pelo que arcos grandes ou muito excêntricos recebem mais segmentos sem penalizar os arcos simples

XLSDecodeVectorScene valida cabeçalhos EMF e WMF, alinhamento e tamanhos de registos, totais declarados, posicionamento exato do EOF e limites de recursos sem invocar a reprodução de metaficheiros da plataforma; a whitelist nativa reproduz pilhas de estado de contextos de dispositivo com save e restore, mapeamento de janela e viewport combinado com transformações globais, tabelas de objetos de caneta, pincel e caneta estendida incluindo stock objects, retângulos, elipses, cadeias de linhas, polígonos, polilinhas e curvas de Bézier com estilos de tracejado, parênteses de path com passagens de preenchimento, contorno e contorno-e-preenchimento combinadas, retângulos arredondados, arcos, cordas, setores e arcos de ângulo através de conversão exata de arco para Bézier, preenchimentos e molduras de regiões a partir de retângulos RGNDATA limitados, sequências de texto limitadas com tipos de letra, cores e alinhamento, e imagens stretch-DIB restritas recodificadas como PNG através de Canvas e SVG, rejeita os registos escape, e deixa o recorte e os registos privados para o fallback limitado existente

Outlines PDF e callbacks de página

Os outlines PDF vivem na coleção Bookmarks (tipo TXLSPDFBookmarks): Add e AddForSheet acrescentam entradas, Delete remove uma, e Count com Items enumeram a árvore. Cada entrada TXLSPDFBookmark suporta entradas pai e filhas (Children), cadeias de irmãos, títulos Unicode, cores (Color), um destino PageNumber , o SheetName de origem para bookmarks de folhas de cálculo, e sinalizadores de negrito ou itálico (conjunto de TXLSPDFBookmarkStyle: xlsPdfBookmarkBold, xlsPdfBookmarkItalic), além de descendentes expandidos ou recolhidos; os bookmarks automáticos de folhas de cálculo utilizam o mesmo modelo de hierarquia e AutoSheetBookmarks alterna a sua geração

BeforeNewPage pode ajustar a caixa de cada página, enquanto BeforeGeneratePage e AfterGeneratePage desenham conteúdo de fundo ou de sobreposição através dos auxiliares públicos de página AppendPageContent, FillPageRectangle, StrokePageRectanglee DrawPageText

Assinaturas e anexos

TXLSPDFSignature configura campos de assinatura visíveis ou invisíveis, enquanto CertificationPolicy cria opcionalmente uma assinatura de certificação DocMDP que não permite alterações, permite preencher e assinar formulários, ou permite preencher, assinar e anotar formulários; o PDF/A-1 não permite esta funcionalidade do PDF 1.5 e é rejeitado antes de a saída ser confirmada

TXLSPDFCertificationPolicy disponibiliza xlsPdfApprovalSignature, xlsPdfCertifyNoChanges, xlsPdfCertifyFormFillingAndSigninge xlsPdfCertifyFormFillingSigningAndAnnotations para selecionar explicitamente a política de assinatura

Um TXLSPDFSignDigestEvent recebe o resumo (digest) e devolve dados CMS criados pelo anfitrião, pelo que o HotXLS nunca precisa de uma chave privada

TXLSPDFExport.Signature anexa a configuração da assinatura e os perfis PDF/A-3 podem incluir ficheiros associados validados através de AddAttachment, que coloca um TXLSPDFAttachmentem fila; a sobrecarga detalhada aceita um nome de apresentação Unicode, tipo MIME, descrição, hora de modificação, payload e um valor TXLSPDFAttachmentRelationship de Source, Data, Alternative, Supplement ou Unspecified, enquanto AttachmentCount comunica o total em fila e AttachmentDuplicatePolicy (tipo TXLSPDFAttachmentDuplicatePolicy) seleciona como os nomes iguais são tratados

TXLSPDFSignature.ImageData, ImageFormate ImageFit (tipo TXLSPDFSignatureImageFit: contain, cover ou stretch) colocam um PNG na aparência normal do Form antes de o byte range ser congelado; os modos contain, cover e stretch partilham a cache de imagens do documento, enquanto as imagens inválidas falham antes da assinatura

A sobrecarga IXLSPDFAttachmentSource permanece lazy até à gravação, invoca cada fonte uma vez por gravação e faz spool de, no máximo, 256 MiB antes de o objeto EmbeddedFile ser criado, para que as falhas do fornecedor deixem a transação do destino inalterada

A montagem final escreve os objetos sequencialmente no destino em vez de construir uma única string de documento completo: as exportações não assinadas são transmitidas diretamente para fluxos forward-only, cada EmbeddedFile referencia o seu tamanho em bytes através de um objeto /Length indireto emitido depois do payload, e os bytes do fornecedor são copiados do spool em blocos fixos; as exportações assinadas montam-se num spool de documento limitado que recebe as correções ByteRange e do conteúdo da assinatura, um SHA-256 incremental sobre os dois intervalos cobertos e uma única cópia forward

A saída PDF/A-3 escreve cada ficheiro associado tanto na árvore de nomes EmbeddedFiles como no array AF do catálogo, com um nome Unicode UF , um PDF Name MIME com escape, AFRelationship, tamanho em bytes, data de modificação opcional e descrição opcional; o PDF/A-1 e o PDF/A-2 rejeitam os anexos em fila antes de confirmar a saída

Metadados do documento

DocumentTitle, DocumentAuthor, DocumentSubject, DocumentKeywordse DocumentFileName preenchem os dicionários de informação e metadados do PDF

Fallback de tipos de letra

TXLSPDFExport.SetFontFallbackChain, AddFontFallbacke ClearFontFallbackChains configuram níveis de fallback específicos da família de origem e do estilo; LoadedFallbackFontCount expõe a contagem de faces em cache e FontFallbackSelectionCacheCount o número de decisões de fallback por seleção em cache, ambos para diagnóstico

TXLSPDFExport.FontSize define o tamanho de texto predefinido em pontos, com 9 como predefinição

A seleção de fallback utiliza a cobertura de glifos e preserva mapeamentos Unicode, escalares suplementares, agrupamentos de grafemas, agrupamentos de modelagem e faces TTC autónomas

OnGetFontDirectories pode devolver um ou mais diretórios de tipos de letra separados por ponto e vírgula para uma família e estilo pedidos; os diretórios aceites são pesquisados recursivamente uma única vez, indexados por metadados internos de família/estilo e postos em cache para medições e desenhos subsequentes

Política de incorporação de tipos de letra

TXLSPDFExport.FontEmbedding (tipo TXLSPDFFontEmbedding) seleciona incorporação automática, subsetting obrigatório, o programa de tipos de letra completo ou saída apenas com mapeamento através de xlsPdfFontEmbedAuto, xlsPdfFontEmbedSubset, xlsPdfFontEmbedFulle xlsPdfFontEmbedNone; o subsetting obrigatório falha atomicamente quando não é possível produzir um subconjunto válido, as faces TTC são convertidas em tipos de letra autónomos, e o PDF/A rejeita a saída apenas com mapeamento

OnFontEmbed dispara uma vez por face Unicode antes de as respetivas métricas, mapa de caracteres, shaping e identificadores de glifos serem resolvidos; definir Handled aceita o modo por tipo de letra devolvido e os bytes de substituição opcionais, enquanto o deixar a false mantém a política do documento e a face original

Os tipos de letra OpenType autónomos com contornos CFF são incorporados através de FontFile3 com um stream OpenType e um descendente CIDFontType0 ; os modos automático e completo retêm o programa completo, enquanto o subsetting CFF obrigatório falha atomicamente porque não consegue preservar um subconjunto válido

Os tipos de letra incorporados que transportam dados GPOS OpenType ou kern legado utilizam avançamentos de glifos posicionados para texto simples e complexo, pelo que a medição, o wrapping, o alinhamento e as posições de glifos emitidas partilham o mesmo resultado de kerning

Progresso e cancelamento

TXLSPDFExport.OnProgress e OnProgressEx comunicam as fases de início, página e fim; Cancel solicita o cancelamento e Aborted comunica o estado final sem confirmar um fluxo parcial

Veja também

• TXLSPaginationModel
• SaveAsPDF
• Fluxos de trabalho avançados de livros de trabalho