Avanceret gengivelse og eksport

PDF-, SVG-, bitmap-, metafil-, forhåndsvisnings- og udskriftsstier deler én pageringsmodel og backend-neutral geometri, samtidig med at formatspecifikke kodere bevares

Brugerdefinerede grafik-backends

TXLSGraphicsTextAlign definerer venstre-, midter- og højrejustering af tekst for TXLSGraphicsBackend; de stylede tegnekald tager resten af de fælles enums — skrifttypetilstande (TXLSGraphicsFontStyles), line caps (TXLSGraphicsLineCap), dash-mønstre (TXLSGraphicsLineDash) og lodret tekstjustering (TXLSGraphicsTextVAlign)

Implementeringer modtager koordinater i punkter, opløste tekst- og billedeffekter, klipning og side-lokal tegneplacering uden at skulle gentage arbejdsbogens layout-logik. Hver tegning på en logisk side ankommer som en TXLSPageDrawingPlacement -post, hvis Kind (TXLSPageDrawingKind: xpdkImage, xpdkChart, xpdkTextBox, xpdkShape, xpdkControl) fortæller backenden, hvad den er ved at male; fliser til regnearksbaggrunde ankommer som afkodede TXLSSheetBackgroundRenderData

Rendergeometri ejet af operationen

TXLSPaginationModel.RenderBackend vælger backend-identiteten, som det næste Build -kald indfanger, og RenderGeometry eksponerer den resulterende uforanderlige kalibrering, projektmappens generation, backend og den begrænsede metric-cache-tilstand; den aktive render-session rejser som et TXLSRenderSession -handle, og farvepolitikken er en TXLSRenderColorMode (xlsrcColor eller xlsrcMonochrome)

PDF-modeller bruger xlsrgbPdf, SVG bruger xlsrgbSvg, sidebilleder bruger xlsrgbBitmap, udskrifts- og forhåndsvisningsmodeller bruger xlsrgbPrintPreview, og TXLSWorkbookViewer bruger xlsrgbViewer; PaginationModel på SVG-, billed-, udskrifts- og viewer-komponenter eksponerer den aktive model til diagnostik uden at overføre ejerskab

Klassiske og XLSX HTML-indgange indfanger xlsrgbHtml; TXLSHTMLExport.RenderGeometry eksponerer det nyeste Classic-snapshot, mens TXLSXHtmlExportSession.RenderGeometry eksponerer snapshotet, der bevares på tværs af alle ark i en inkrementel eksport

HTML-kolonneoutput konverterer arbejdsbogens tegnbreddemodel gennem Normal-fontens maksimale cifferbredde og den konfigurerede skærmskalering, før der udsendes en fast CSS-pixellængde; konvertering mellem punkter og pixels bruger samme indfangede målings-DPI

Hver operation bevarer sin indfangede kalibrering, selv hvis projektmappen ændres senere, og gengivelsen skriver aldrig regnearkenes rækkehøjder eller kolonnebredder. Pagineringen bygger sider ud fra TXLSLogicalPage -objekter, hvis tegninger, orientering (TXLSPageOrientation: xpoPortrait eller xpoLandscape) og kommentarplacering (TXLSPrintComments: xpcNone eller xpcAtEnd) kommer fra den opløste sideopsætning

En logisk side eksponerer alt, hvad en backend eller callback har brug for: identitet (DocumentPageNumber, SheetPageNumber, SheetName, den ejer ClassicWorksheet eller XlsxWorksheet), geometri (PageWidth, PageHeight, Scaleog værdierne LeftMargin, RightMargin, TopMargin, BottomMargin, HeaderMarginog FooterMargin ), datarektanglet (DataFirstRow, DataLastRow, DataFirstCol, DataLastCol) med udskriftstitler (RepeatFirstRow, RepeatLastRow, RepeatFirstCol, RepeatLastCol), baggrundsplacering (BackgroundOffsetX, BackgroundOffsetY), gitterlinjeoutput (PrintGridlines, GridlineColor), de seks sidehoved- og sidefodbåndstekster (LeftHeader, CenterHeader, RightHeader, LeftFooter, CenterFooter, RightFooter) og sidens række- og kolonneskeletter (RowCount med Rows og RowEdges, ColumnCount med Columns og ColumnEdges) plus dens tegneliste (DrawingCount og Drawings). ExpandHeaderFooter opløser sidehovedets og sidefodens formatkoder mod siden, og ExpandHeaderFooterStyled rapporterer derudover den ledende punktstørrelse og farve, så brugerdefinerede paintere kan matche Excels egen gengivelse af sidehoveder

Flettede celler i native paginering

TXLSPaginationModel.RenderPageToBackend opløser et flettet område til dets oprindelige anker og maler ét synligt rektangel pr. sidefragment; dækkede celler udsender ikke duplikeret tekst eller interne gitterlinjer

XLSX-fragmenter deler ankerets fyld, justering, ombrydning, font og evaluering af betinget formatering, mens eksplicitte ydre kantsegmenter forbliver synlige, og interne flettekanter undertrykkes; Classic-fragmenter deler ankerets tekst og ensfarvede fyld gennem den eksisterende Classic-tekstmaler

Et udskriftsområde eller et sideskift kan klippe et flettet område, og hvert synligt fragment bruger det oprindelige anker, selv når ankeret ligger uden for det udskrevne område; skjulte rækker og kolonner bidrager med udstrækning nul, og gentagne udskriftstitel-fragmenter bruger den samme ankerpolitik

Fletning tvinger ikke et område ind på én side, udvider ikke udskriftsområdet og ændrer ikke lagrede rækkehøjder og kolonnebredder; pagineringen bevarer den eksisterende sideopsætning og klipper hvert fragment til sin logiske side

Gengivelse af regnearksbaggrunde

Arbejdsbogens fremviser viser gyldige Classic- og XLSX-regnearksbaggrunde som gentagne fliser bag ufyldte celler, mens eksplicitte og betingede cellefyld forbliver over baggrunden

TXLSPaginationModel, TXLSSvgExport, TXLSPageImageExporter, TXLSPrintDocument, TXLSPDFExport, TXLSHTMLExport, TXLSXHtmlExportOptionsog TXLSWorkbookViewer eksponerer ExportSheetBackgroundImages; standarden er False for udskrifts-, forhåndsvisnings-, metafil-, PDF-, SVG-, bitmap- og HTML-output. Regneark gemmer deres nyttelast med et TXLSSheetBackgroundFormat -billedformat, og de afkodede byte rejser som en TXLSSheetBackgroundResource , der er nøglet til generation, DPI og farvetilstand

Aktiveret sideret output forankrer flisefasen til regnearkskoordinater på tværs af sidegrænser og bevarer ét afkodet billede pr. regneark, ressourcegeneration, backend, DPI og farvetilstand for render-sessionen; BackgroundDecodeCount eksponerer det samlede antal afkodninger til diagnostik, mens korrupte nyttelaster springes over med en projektmappe-diagnostik. Den aktive TXLSRenderSession styrer selv det delte cache: AcquireBackground henter (eller afkoder én gang) de tiled TXLSSheetBackgroundRenderData for et regneark, DrawTiledBackground maler dem hen over et klippet sideområde, og DecodeCount rapporterer, hvor mange nyttelaster der er afkodet indtil videre

Visningspolitik for arbejdsbogsobjekter

ObjectDisplayMode vælger xlsodmShowAll, xlsodmShowPlaceholderseller xlsodmHideAll for både Classic XLS- og XLSX-projektmapper; fremviseren bruger alle tre tilstande og anvender billige bokse med type, navn, tekst og alternativ tekst til placeholder-tilstand

PDF-, SVG-, bitmap-, fysisk udskrifts- og XLSX HTML-eksportører behandler placeholder-tilstand som fuld objektoutput som standard; sæt ExportObjectPlaceholders på den tilsvarende eksportør eller HTML-indstilling for at bede om bokse uden billedafkodning eller opbygning af diagramscener

xlsodmHideAll er en tidligere global port, der forhindrer indsamling af tegninger, objektdrevet områdeudvidelse, hit-testning og mediegengivelse; regnearksbaggrunde, ikoner fra betinget formatering, billeder i sidehoved eller sidefod, celler og eksportørspecifikke udskriftsobjektfiltre forbliver uafhængige

Opfriskning af diagramkildedata

XLSX-diagramserialisering og delt diagramrendering opløser lokale seriecacher mod arbejdsbogens aktuelle generation, så redigeringer af kildeceller, genberegning og synlighedsændringer opfrisker værdier, kategorier, boblestørrelser og områdebundne serienavne før output

Almindelige kildeområder skal være én enkelt række eller kolonne af lokale A1-referencer; citerede arkenavne understøttes, og et ukvalificeret område opløses mod diagrammets ejerregneark; hierarkiske kategoriniveauer bevarer deres separate resolver for rektangulære områder

Kategoritekst bruger formateret celletekst, numeriske cacher beholder tomme punktpladser for blanke og ikke-numerisk tekst, fejlceller bevarer deres viste fejl-literaler, og datoer bruger arbejdsbogens 1900- eller 1904-seriedatosystem; PlotVisibleOnly bestemmer, om skjulte kilderækker og -kolonner udelades

Importerede eller manuelt udfyldte cacher bevares, når en lokal kilde aldrig er blevet materialiseret, mens cacher, der allerede styres fra lokale celler, rydder forældede punkter efter sletning; TXLSXChartSeries.RefreshDataCaches opfrisker eksplicit opløselige lokale kilder, inklusive et tomt kildeområde

Referencer til eksterne projektmapper og ikke-understøttede referenceudtryk bevarer deres lagrede cacher; cacheopfriskning åbner ikke eksterne filer eller udfører netværksanmodninger

Kalenderbevidste diagramdatoakser

TXLSXChartSeries.ResolveDataCaches opløser understøttede lokale serieskilder for den aktuelle generation, og RefreshDataCaches anmoder om en eksplicit opfriskning, selv når en tom kilde ikke har nogen cellehistorik

XLSX-diagrammer, hvis kategoriakse bruger xlsxAxisDate , afbilder hver gyldig kategori gennem arbejdsbogens 1900- eller 1904-seriedatosystem og bevarer den reelle afstand mellem spredte datoer i stedet for at tildele lige punktpladser

BaseTimeUnit styrer normalisering til dag, måned eller år, mens MajorUnit, MinorUnit, MajorTimeUnitog MinorTimeUnit rykker ticks frem i kalenderenheder; måneds- og årsintervaller forbliver derfor justerede på tværs af uens månedslængder og skudår

Den samme begrænsede tick-samling leverer koordinater, etiketter, ticks og ønskede gitterlinjer til pageringsbaseret PDF-, SVG-, bitmap-, forhåndsvisnings-, udskrifts- og viewer-output, mens XLSX HTML bruger den fælles kalenderaritmetik til sit inline diagram-SVG

Selvstændig PDF-skriver

TXLSPDFWriter opretter PDF-dokumenter, der ikke stammer fra en projektmappe, såsom fakturaer, billetter, etiketter og overlay-formularer; BeginDoc sætter en punktpræcis sidekasse, NewPage afslutter den aktuelle side, og SaveToStream eller SaveToFile færdiggør dokumentet

Tegnemetoderne bruger PDF-punkter fra nederste venstre hjørne og bibliotekets farver i $00BBGGRR - eller $AABBGGRR -form; de tilgængelige primitiver dækker FillRectangle, StrokeRectangle, ClipRectangle, MeasureText, SaveGraphicsStateog RestoreGraphicsState til fyldte og stregede rektangler, linjer, ellipser, stylet tekst med nøjagtig breddemåling, affine transformationer, rektangulær klipning og eksplicit gem eller gendan af grafiktilstand, mens PageWidth og PageHeight rapporterer den aktuelle sidekasse i punkter

SVG-eksport

TXLSSvgExport leverer syv SaveAsSVG -overloads til klassiske og XLSX-intervaller, regneark, arbejdsbøger og forberedte logiske sider samt output af navngivne objekter, hvor det understøttes

UseWorksheetPageSetup, Orientationog Margin bruger de samme sideopsætningsbeslutninger som PDF- og forhåndsvisningsuddata

TXLSSvgExport.PrintComments (typen TXLSPrintComments) vælger, hvordan cellekommentarer udsendes til sideret SVG-output; når den er sat til xpcAtEnd, tilføjer arket sidste side en kommentarliste (celleadresse, forfatter og tekst) under dataområdet, mens xpcNone udelader kommentarer

ExportPages sender ét komplet SVG-dokument ad gangen gennem OnPage, rapporterer antallet af forpligtede sider gennem ExportedPageCountog stopper, før senere sider genereres, når callbacken annullerer; IdPrefix skaber deterministiske dokument- og sidenavnerum til clip-paths, filtre, mønstre og delte ressourcer

HyperlinkMode (typen TXLSSvgHyperlinkMode) med xshmSafe tilføjer klippede gennemsigtige hit-regioner efter det visuelle indhold; tilladte eksterne skemaer er HTTP, HTTPS, mail, FTP og relative links, mens aktive, lokale, UNC- og kontroltegn-mål udelades; LinksInNewWindow tilføjer noopener noreferrer -beskyttelse, og ScreenTips bliver til SVG-titler

Inkrementelt PNG-, JPEG- og multipage TIFF-output

TXLSPageImageFormat vælger PNG- eller JPEG-uddata, og TXLSPageImageExporter holder én pageringssession i live, mens hver færdig bitmap frigives omgående

Tagget PDF og PDF/A

TXLSPDFExport.TagMode aktiverer automatisk struktur for dokument, tabel, række, sidehovedcelle, datacelle og informative billeder med tætte side-lokale marked-content-identifikatorer, nøjagtige parent-træ-afbildninger, spænd for flettede celler og artefakt-isolering; udskriftstitelrækker og tabelhovedrækker bliver semantiske sidehovedceller, XLSX-billeder med ikke-tom AltText bliver selvstændige Figure-elementer med Unicode-alternativtekst, og billeder uden alternativ tekst forbliver dekorative artefakter

Hver synlig informativ billedinstans får sit eget Figure-element og marked-content-identifikator, selv når ens billednyttelaster deler ét PDF XObject; AltTextTitle erstatter ikke manglende alternativ tekst, diagrammer forbliver artefakter, og denne fokuserede strukturunderstøttelse gør ikke krav på fuld PDF/UA-overensstemmelse

TXLSPDFExport.PDFAProfile vælger PDF/A-1, PDF/A-2 eller PDF/A-3 på overensstemmelsesniveau a eller b; inkompatibel kryptering, skrifttyper, vedhæftninger, gennemsigtighed, signaturer og metadata valideres, før outputstreamen forpligtes

TXLSPDFExport.ExportCommentsAsAnnotations placerer Unicode-forfatter- og kommentartekst på de oprindelige cellevisningsrektangler, mens den traditionelle kommentarer-til-sidst-output forbliver uafhængigt konfigurerbar

UsePDFA er kompatibilitetskontakten for PDF/A-1b, mens UseXRefStream vælger cross-reference-streams, hvor den valgte profil tillader dem

Sidegeometri og -valg

De seks CalculatePageCount -overloads accepterer klassiske og XLSX-intervaller, regneark eller arbejdsbøger uden at opbygge PDF-objekter

PaperWidth og PaperHeight tilsidesætter papirdimensionerne i punkter, LastPage lukker det 1-baserede outputinterval, Orientation (typen TXLSPDFOrientation) vælger portræt- eller landskabsoutput, HidePrintObjects (en mængde af TXLSPDFHidePrintObject: xlsPdfHideHeaders, xlsPdfHideFooters) undertrykker valgte sidehoved- eller sidefodbånd, og PageLayout (typen TXLSPDFPageLayout) angiver det indledende sidearrangement i visningsprogrammet

PDF-sidetilstand og åbningshandling

TXLSPDFExport.PageMode (typen TXLSPDFPageMode) angiver, hvordan et PDF-visningsprogram arrangerer panelerne, når dokumentet åbnes, via xlsPdfModeDefault, xlsPdfModeUseOutlines, xlsPdfModeUseThumbs, xlsPdfModeFullScreen, xlsPdfModeUseOCog xlsPdfModeUseAttachments

OpenAction (typen TXLSPDFOpenAction) vælger visningsprogrammets oprindelige adfærd med xlsPdfOpenNone, xlsPdfOpenPageeller xlsPdfOpenOutlines. For xlsPdfOpenPageer OpenActionPage den 1-baserede målside (klemt til sideantallet), og OpenActionZoom er den oprindelige forstørrelsesfaktor, hvor 0 bevarer visningsprogrammets standardzoom eller tilpasning

Delt adaptiv vektorgeometri

XLSBuildEllipticArcCubics konverterer en ellipsebue til kubiske Bezier-segmenter ved rekursivt at håndhæve en af kalderen valgt fladhedsgrænse; PDF-, SVG- og bitmap-gengivelse bruger denne delte geometri, så store eller stærkt excentriske buer får flere segmenter uden at straffe simple buer

XLSDecodeVectorScene validerer EMF- og WMF-headere, postjustering og -størrelser, deklarerede totaler, nøjagtig EOF-placering og ressourcegrænser uden at kalde platformens metafile-afspilning; den native whitelist afspiller device-context-tilstandsstakke med save og restore, window- og viewport-mapping kombineret med world-transformationer, pen-, brush- og extended-pen-objekttabeller inklusive stock-objekter, rektangler, ellipser, linjekæder, polygoner, polylinjer og Bézier-kurver med dash-typer, path-parenteser med fill, stroke og kombineret stroke-and-fill, afrundede rektangler, buer, akkorder, kagetstykker og vinkelbuer gennem nøjagtig arc-til-Bézier-konvertering, regionfyld og -rammer fra afgrænsede RGNDATA-rektangler, afgrænsede tekstforløb med skrifttyper, farver og justering samt begrænsede stretch-DIB-billeder, der genkodes som PNG gennem Canvas og SVG, afviser escape-poster og overlader klipning og private poster til den eksisterende afgrænsede fallback

PDF-outlines og side-callbacks

PDF-outlines ligger i Bookmarks -samlingen (typen TXLSPDFBookmarks): Add og AddForSheet tilføjer poster, Delete fjerner én, og Count med Items optæller træet. Hver TXLSPDFBookmark -post understøtter overordnede og underordnede poster (Children), søsterkæder, Unicode-titler, farver (Color), et PageNumber -mål, kilde- SheetName til regnearks-bookmarks samt fed- og kursiv-flag (mængde af TXLSPDFBookmarkStyle: xlsPdfBookmarkBold, xlsPdfBookmarkItalic) plus udvidede eller sammenklappede efterkommere; automatiske regnearks-bookmarks bruger samme hierarkimodel, og AutoSheetBookmarks tænder og slukker for deres generering

BeforeNewPage kan justere hver sidekasse, mens BeforeGeneratePage og AfterGeneratePage tegner baggrunds- eller overlayindhold gennem de offentlige sidehjælpere AppendPageContent, FillPageRectangle, StrokePageRectangleog DrawPageText

Signaturer og vedhæftninger

TXLSPDFSignature konfigurerer synlige eller usynlige signaturfelter, mens CertificationPolicy valgfrit opretter en DocMDP-certificeringssignatur, der tillader ingen ændringer, udfyldning og signering af formularer eller udfyldning, signering og annotationer af formularer; PDF/A-1 tillader ikke denne PDF 1.5-funktion og afvises, før outputtet forpligtes

TXLSPDFCertificationPolicy leverer xlsPdfApprovalSignature, xlsPdfCertifyNoChanges, xlsPdfCertifyFormFillingAndSigningog xlsPdfCertifyFormFillingSigningAndAnnotations til eksplicit at vælge signaturpolitikken

En TXLSPDFSignDigestEvent modtager digestet og returnerer værtsoprettede CMS-data, så HotXLS aldrig behøver en privat nøgle

TXLSPDFExport.Signature vedhæfter signaturkonfigurationen, og PDF/A-3-profiler kan inkludere validerede tilknyttede filer gennem AddAttachment, som sætter en TXLSPDFAttachmenti kø; den detaljerede overload accepterer et Unicode-visningsnavn, MIME-type, beskrivelse, ændringstidspunkt, nyttelast og en TXLSPDFAttachmentRelationship -værdi af Source, Data, Alternative, Supplement eller Unspecified, mens AttachmentCount rapporterer det samlede antal i køen, og AttachmentDuplicatePolicy (typen TXLSPDFAttachmentDuplicatePolicy) vælger, hvordan ens navne håndteres

TXLSPDFSignature.ImageData, ImageFormatog ImageFit (typen TXLSPDFSignatureImageFit: contain, cover eller stretch) placerer et PNG i den normale Form til udseende, før byte-rangen fryses; contain-, cover- og stretch-tilstande deler dokumentets billedcache, mens ugyldige billeder fejler, før der signeres

The IXLSPDFAttachmentSource -overloaden forbliver doven indtil gem, kaldes én gang pr. kilde pr. gem og spooler højst 256 MiB, før EmbeddedFile-objektet oprettes, så providerfejl efterlader destinationens transaktion uændret

Den endelige samling skriver objekterne sekventielt til destinationen i stedet for at opbygge én hel dokumentstreng: usignerede eksporter streamer direkte ind i forward-only-streams, hver EmbeddedFile refererer sin byte-størrelse gennem et indirekte /Length -objekt, der udsendes efter nyttelasten, og provider-byte kopieres fra spoolen i faste portioner; signerede eksporter samles i en afgrænset dokument-spool, der modtager ByteRange - og signaturindholds-patches, en inkrementel SHA-256 over de to dækkede ranges og én enkelt fremadrettet kopiering

PDF/A-3-output skriver hver tilknyttet fil ind i både EmbeddedFiles-navnetræet og katalogens AF-array med et Unicode- UF -navn, escaped MIME PDF Name, AFRelationship, byte-størrelse, valgfri ændringsdato og valgfri beskrivelse; PDF/A-1 og PDF/A-2 afviser vedhæftninger i køen, før outputtet forpligtes

Dokumentmetadata

DocumentTitle, DocumentAuthor, DocumentSubject, DocumentKeywordsog DocumentFileName udfylder PDF'ens informations- og metadataordbøger

Font-fallback

TXLSPDFExport.SetFontFallbackChain, AddFontFallbackog ClearFontFallbackChains konfigurerer kildefamilie- og stilspecifikke fallback-niveauer; LoadedFallbackFontCount viser antallet af cachelagrede flader, og FontFallbackSelectionCacheCount antallet af cachelagrede fallback-beslutninger pr. valg, begge dele til diagnostik

TXLSPDFExport.FontSize sætter standardtekststørrelsen i punkter, med 9 som standard

Fallback-valg bruger glyfdækning og bevarer Unicode-kortlægninger, supplerende skalarer, grafemklynger, formningsklynger og selvstændige TTC-flader

OnGetFontDirectories kan returnere én eller flere semikolonseparerede fontmapper for en forespurgt familie og stil; accepterede mapper gennemsøges rekursivt én gang, indekseres efter intern familie-/stil-metadata og cachelagres til efterfølgende måling og tegning

Politik for font-indlejring

TXLSPDFExport.FontEmbedding (typen TXLSPDFFontEmbedding) vælger automatisk indlejring, påkrævet subsetting, det komplette fontprogram eller map-only-output gennem xlsPdfFontEmbedAuto, xlsPdfFontEmbedSubset, xlsPdfFontEmbedFullog xlsPdfFontEmbedNone; påkrævet subsetting fejler atomært, når et gyldigt subset ikke kan produceres, TTC-flader konverteres til selvstændige fonts, og PDF/A afviser map-only-output

OnFontEmbed udløses én gang pr. Unicode-flade, før dens metrics, tegnkort, formning og glyf-identifikatorer opløses; sæt Handled for at acceptere den returnerede per-font-tilstand og eventuelle erstatningsbyte, mens den efterlades false bevarer dokumentpolitikken og den originale flade

Selvstændige OpenType-fonts med CFF-outlines indlejres gennem FontFile3 med en OpenType -stream og en CIDFontType0 -efterkommer; automatisk og fuld tilstand bevarer det komplette program, mens påkrævet CFF-subsetting fejler atomært, fordi den ikke kan bevare et gyldigt subset

Indlejrede fonts med OpenType GPOS - eller ældre kern -data bruger positionerede glyf-afstande til simpel og kompleks tekst, så måling, ombrydning, justering og de udsendte glyfpositioner deler samme kerning-resultat

Fremskridt og annullering

TXLSPDFExport.OnProgress og OnProgressEx rapporterer begyndelses-, side- og slutningsfaser; Cancel anmoder om annullering, og Aborted rapporterer den endelige tilstand uden at forpligte en delvis stream

Se også

• TXLSPaginationModel
• SaveAsPDF
• Avancerede arbejdsbogs-arbejdsgange