Avancerad rendering och export

PDF-, SVG-, bitmapps-, metafil-, förhandsgransknings- och utskriftssökvägar delar en gemensam pagineringsmodell och backend-neutral geometri samtidigt som formatspecifika kodare behålls

Anpassade grafikbackends

TXLSGraphicsTextAlign definierar vänster-, center- och högertextjustering för TXLSGraphicsBackend; formaterade ritningsanrop tar de återstående gemensamma enumerna — teckensnittsstilar (TXLSGraphicsFontStyles), linjeändar (TXLSGraphicsLineCap), streckmönster (TXLSGraphicsLineDash) och vertikal textjustering (TXLSGraphicsTextVAlign)

Implementeringar tar emot koordinater i punkter, upplösta text- och bildeffekter, klippning och sidlokal ritningsplacering utan att behöva upprepa arbetsbokens layoutlogik. Varje ritning på en logisk sida kommer som en TXLSPageDrawingPlacement -post vars Kind (TXLSPageDrawingKind: xpdkImage, xpdkChart, xpdkTextBox, xpdkShape, xpdkControl) talar om för backend:en vad den ritar; kalkylbladsbakgrundens tiles kommer som avkodade TXLSSheetBackgroundRenderData

Operationsägd rendergeometri

TXLSPaginationModel.RenderBackend väljer den backendidentitet som nästa Build -anrop fångar, och RenderGeometry exponerar den resulterande oföränderliga kalibreringen, arbetsboksgenerationen, backend:en och det avgränsade måttcachetillståndet; den aktiva rendersessionen transporteras som ett TXLSRenderSession -handtag och färgpolicyn är en TXLSRenderColorMode (xlsrcColor eller xlsrcMonochrome)

PDF-modeller använder xlsrgbPdf, SVG använder xlsrgbSvg, sidbilder använder xlsrgbBitmap, utskrifts- och förhandsgranskningsmodeller använder xlsrgbPrintPreview, och TXLSWorkbookViewer använder xlsrgbViewer; PaginationModel på SVG-, bild-, utskrifts- och visarkomponenter exponerar den aktiva modellen för diagnostik utan att ägarskapet överförs

Klassiska och XLSX HTML-ingångspunkter fångar xlsrgbHtml; TXLSHTMLExport.RenderGeometry exponerar den senaste klassiska ögonblicksbilden, medan TXLSXHtmlExportSession.RenderGeometry exponerar den ögonblicksbild som behålls över alla blad i en inkrementell export

HTML-kolumnutdata konverterar arbetsbokens teckenbreddsmodell via Normal-teckensnittets maximala sifferbredd och konfigurerad skärmskalning innan en fast CSS-pixellängd skrivs ut; punkt- och pixelkonvertering använder samma fångade mät-DPI

Varje operation behåller sin fångade kalibrering även om arbetsboken ändras senare, och renderingen skriver aldrig kalkylbladens radhöjder eller kolumnbredder. Pagineringen bygger sidor från TXLSLogicalPage -objekt vars ritningar, orientering (TXLSPageOrientation: xpoPortrait eller xpoLandscape) och kommentarsplacering (TXLSPrintComments: xpcNone eller xpcAtEnd) kommer från den upplösta sidinställningen

En logisk sida exponerar allt som en backend eller callback behöver: identitet (DocumentPageNumber, SheetPageNumber, SheetName, det ägande ClassicWorksheet eller XlsxWorksheet), geometri (PageWidth, PageHeight, Scalesamt värdena LeftMargin, RightMargin, TopMargin, BottomMargin, HeaderMarginoch FooterMargin ), datarektangeln (DataFirstRow, DataLastRow, DataFirstCol, DataLastCol) med utskriftsrubriker (RepeatFirstRow, RepeatLastRow, RepeatFirstCol, RepeatLastCol), bakgrundsplacering (BackgroundOffsetX, BackgroundOffsetY), gitterlinjeutdata (PrintGridlines, GridlineColor), de sex sidhuvuds- och sidfotsbandstexterna (LeftHeader, CenterHeader, RightHeader, LeftFooter, CenterFooter, RightFooter) samt sidans rad- och kolumnskelett (RowCount med Rows och RowEdges, ColumnCount med Columns och ColumnEdges) plus dess ritningslista (DrawingCount och Drawings). ExpandHeaderFooter löser sidhuvudets och sidfotens formatkoder mot sidan, och ExpandHeaderFooterStyled rapporterar dessutom den inledande punktstorleken och färgen så att anpassade ritare kan matcha Excels egen sidhuvudsrendering

Sammanfogade celler i inbyggd paginering

TXLSPaginationModel.RenderPageToBackend löser upp ett sammanslaget område till dess ursprungliga ankare och målar en synlig rektangel per sidfragment; täckta celler emitterar ingen duplicerad text eller interna gitterlinjer

XLSX-fragment delar ankarets fyllnad, justering, radbrytning, typsnitt och utvärdering av villkorsstyrd formatering, medan explicita yttre kantsegment förblir synliga och interna kantlinjer i sammanslagningen undertrycks; klassiska fragment delar ankarets text och heldräkta fyllnad genom den befintliga klassiska textritaren

Ett utskriftsområde eller en sidbrytning kan klippa ett sammanslaget område, och varje synligt fragment använder det ursprungliga ankaret även när det ankaret ligger utanför utskriftsområdet; dolda rader och kolumner bidrar med noll utsträckning, och upprepade fragment av utskriftsrubriker använder samma ankarpolicy

Sammanfogning tvingar inte ett område till en enda sida, expanderar inte utskriftsområdet eller ändrar lagrade radhöjder och kolumnbredder; pagineringen behåller den befintliga sidinställningen och klipper varje fragment till sin logiska sida

Rendering av kalkylbladsbakgrund

Arbetsboksvisaren visar giltiga klassiska och XLSX-kalkylbladsbakgrunder som upprepade tiles bakom ofyllda celler, medan explicita och villkorsstyrda cellfyllnader förblir ovanför bakgrunden

TXLSPaginationModel, TXLSSvgExport, TXLSPageImageExporter, TXLSPrintDocument, TXLSPDFExport, TXLSHTMLExport, TXLSXHtmlExportOptionsoch TXLSWorkbookViewer exponerar ExportSheetBackgroundImages; standardvärdet är False för utskrifts-, förhandsgransknings-, metafil-, PDF-, SVG-, bitmapps- och HTML-utdata. Kalkylblad lagrar sin nyttolast med ett TXLSSheetBackgroundFormat -bildformat, och de avkodade byte:na transporteras som en TXLSSheetBackgroundResource som nycklas till generation, DPI och färgläge

Aktiverad paginerad utdata förankrar tile-fasen till kalkylbladskoordinater över sidgränserna och behåller en avkodad bild per kalkylblad, resursgeneration, backend, DPI och färgläge för rendersessionen; BackgroundDecodeCount exponerar det totala antalet avkodningar för diagnostik, medan skadade nyttolaster hoppas över med en arbetsboksdiagnostik. Den aktiva TXLSRenderSession hanterar det delade cachet själv: AcquireBackground hämtar (eller avkodar en gång) de sammanfogade TXLSSheetBackgroundRenderData för ett kalkylblad, DrawTiledBackground ritar dem över ett klippt sidområde, och DecodeCount rapporterar hur många nyttolaster som avkodats hittills

Visningspolicy för arbetsboksobjekt

ObjectDisplayMode väljer xlsodmShowAll, xlsodmShowPlaceholderseller xlsodmHideAll för både klassiska XLS- och XLSX-arbetsböcker; visaren konsumerar alla tre tillstånden och använder billiga rutor för typ, namn, text och alternativ text i platshållarläget

PDF-, SVG-, bitmapps-, fysiska utskrifts- och XLSX HTML-exportörer behandlar platshållarläget som fullständig objektutdata som standard; sätt ExportObjectPlaceholders på motsvarande exportör eller HTML-alternativ för att begära rutor utan bildavkodning eller diagramscenskonstruktion

xlsodmHideAll är en tidigare global grind som förhindrar ritningssamling, objektdriven områdesexpansion, träfftestning och medierendering; kalkylbladsbakgrunder, ikoner för villkorsstyrd formatering, bilder i sidhuvud eller sidfot, celler och exportörsspecifika utskriftsobjektsfilter förblir oberoende

Uppdatering av diagramkälldata

XLSX-diagramserialisering och delad diagramrendering löser upp lokala seriecache:er mot arbetsbokens aktuella generation, så att källcellsredigeringar, omberäkning och synlighetsändringar uppdaterar värden, kategorier, bubbelstorlekar och områdeslänkade serienamn före utmatning

Ordinarie källområden måste vara en enskild rad eller kolumn av lokala A1-referenser; citerade kalkylbladsnamn stöds, och ett område utan kvalificerare löses upp mot diagramets ägande kalkylblad; hierarkiska kategorinivåer behåller sin separata upplösare för rektangulära områden

Kategoritext använder formaterad celltext, numeriska cache:er behåller tomma punktplatser för tomma celler och icke-numerisk text, felceller behåller sina visade felleteraler, och datum använder arbetsbokens 1900- eller 1904-seriesystem; PlotVisibleOnly avgör om dolda källrader och kolumner utelämnas

Importerade eller manuellt ifyllda cache:er behålls när en lokal käll aldrig har materialiserats, medan cache:er som redan hanteras från lokala celler rensar inaktuella punkter efter borttagning; TXLSXChartSeries.RefreshDataCaches uppdaterar explicit upplösliga lokala källor, inklusive ett tomt källområde

Referenser till externa arbetsböcker och referensuttryck som inte stöds behåller sina lagrade cache:er; cacheuppdateringen öppnar inte externa filer eller utför nätverksförfrågningar

Kalendermedvetna datumaxlar i diagram

TXLSXChartSeries.ResolveDataCaches löser upp stödda lokala series källor för den aktuella generationen, och RefreshDataCaches begär en explicit uppdatering även när en tom käll inte har någon cellhistorik

XLSX-diagram vars kategoriaxel använder xlsxAxisDate mappar varje giltig kategori genom arbetsbokens 1900- eller 1904-seriedatumssystem och behåller det verkliga avståndet mellan glesa datum i stället för att tilldela lika punktplatser

BaseTimeUnit styr normalisering per dag, månad eller år, medan MajorUnit, MinorUnit, MajorTimeUnitoch MinorTimeUnit flyttar skalstreck i kalenderenheter; månads- och årsintervall förblir därför uppriktade även över månader med olika längd och över skottår

Samma avgränsade skalstreckssamling levererar koordinater, etiketter, skalstreck och begärda gitterlinjer till pagineringsbaserad PDF-, SVG-, bitmapps-, förhandsgransknings-, utskrifts- och visarutdata, medan XLSX HTML använder den gemensamma kalenderaritmetiken för sin interna diagram-SVG

Fristående PDF-skrivare

TXLSPDFWriter skapar PDF-dokument som inte kommer från en arbetsbok, till exempel fakturor, biljetter, etiketter och överläggsformulär; BeginDoc ställer in en punktprecis sidruta, NewPage avslutar den aktuella sidan, och SaveToStream eller SaveToFile färdigställer dokumentet

Ritningsmetoderna använder PDF-punkter från nedre vänstra hörnet och bibliotekets färger i $00BBGGRR - eller $AABBGGRR -form; tillgängliga primitiver omfattar FillRectangle, StrokeRectangle, ClipRectangle, MeasureText, SaveGraphicsStateoch RestoreGraphicsState för fyllda och streckade rektanglar, linjer, ellipser, formaterad text med exakt breddmätning, affina transformationer, rektangulär klippning och explicit sparande eller återställning av grafikläget, medan PageWidth och PageHeight rapporterar den aktuella sidrutan i punkter

SVG-export

TXLSSvgExport tillhandahåller sju SaveAsSVG -överlagringar för klassiska och XLSX-intervall, arbetsblad, arbetsböcker och förberedda logiska sidor, plus namngiven objektutdata där så stöds

UseWorksheetPageSetup, Orientationoch Margin använder samma siduppsättningsbeslut som PDF- och förhandsgranskningsutdata

TXLSSvgExport.PrintComments (typ TXLSPrintComments) väljer hur cellkommentarer skrivs ut för paginerad SVG-utdata; är den satt till xpcAtEndlägger bladets sista sida till en kommentarsförteckning (celladress, författare och text) under dataområdet, medan xpcNone utelämnar kommentarer

ExportPages skickar ett komplett SVG-dokument i taget via OnPage, rapporterar antalet bekräftade sidor via ExportedPageCountoch stannar innan senare sidor genereras när callback:en avbryter; IdPrefix skapar deterministiska dokument- och sidnamnrymder för klippbanor, filter, mönster och delade resurser

HyperlinkMode (typ TXLSSvgHyperlinkMode) med xshmSafe lägger till klippta transparenta träffregioner efter det visuella innehållet; tillåtna externa scheman är HTTP, HTTPS, mail, FTP och relativa länkar, medan aktiva, lokala, UNC- och kontrolteckenmål utelämnas; LinksInNewWindow lägger till noopener noreferrer -skydd och ScreenTips blir SVG-titlar

Inkrementell PNG-, JPEG- och flersidig TIFF-utdata

TXLSPageImageFormat väljer PNG- eller JPEG-utdata och TXLSPageImageExporter håller en pagineringssession vid liv samtidigt som varje färdig bitmapp frigörs omgående

Taggad PDF och PDF/A

TXLSPDFExport.TagMode aktiverar automatisk struktur för dokument, tabell, rad, rubrikcell, datacell och informativ bild med täta sidlokala marked-content-identifierare, exakta föräldraträdmappningar, sammanfogade cellspann och artefaktisolering; utskriftsrubrikrader och tabellrubrikrader blir semantiska rubrikceller, XLSX-bilder med icke-tom AltText blir oberoende Figure-element med Unicode-alternativtext, och bilder utan alternativtext förblir dekorativa artefakter

Varje synlig informativ bildinstans får sitt eget Figure-element och sin egen marked-content-identifierare även när lika bildnyttolaster delar ett PDF-XObject; AltTextTitle ersätter inte saknad alternativtext, diagram förblir artefakter, och det här fokuserade strukturstödet gör inga anspråk på fullständig PDF/UA-överensstämmelse

TXLSPDFExport.PDFAProfile väljer PDF/A-1, PDF/A-2 eller PDF/A-3 på överensstämmelsenivå a eller b; inkompatibel kryptering, teckensnitt, bilagor, transparens, signaturer och metadata valideras innan utdataströmmen bekräftas

TXLSPDFExport.ExportCommentsAsAnnotations placerar Unicode-författare och kommentarstext på ursprungliga cellrektanglar medan den traditionella kommentarer-i-slutet-utdatan förblir oberoende konfigurerbar

UsePDFA är kompatibilitetsbrytaren för PDF/A-1b, medan UseXRefStream väljer korsreferensströmmar där den valda profilen tillåter dem

Sidans geometri och val

De sex CalculatePageCount -överlagringarna accepterar klassiska och XLSX-intervall, arbetsblad eller arbetsböcker utan att bygga PDF-objekt

PaperWidth och PaperHeight åsidosätter pappersmått i punkter, LastPage stänger det enbaserade utdataintervallet, Orientation (typ TXLSPDFOrientation) väljer stående eller liggande utdata, HidePrintObjects (en mängd av TXLSPDFHidePrintObject: xlsPdfHideHeaders, xlsPdfHideFooters) undertrycker valda sidhuvuds- eller sidfotsband, och PageLayout (typ TXLSPDFPageLayout) ställer in läsarens inledande sidarrangemang

PDF-sidläge och öppningsåtgärd

TXLSPDFExport.PageMode (typ TXLSPDFPageMode) ställer in hur en PDF-läsare arrangerar paneler när dokumentet öppnas, via xlsPdfModeDefault, xlsPdfModeUseOutlines, xlsPdfModeUseThumbs, xlsPdfModeFullScreen, xlsPdfModeUseOCoch xlsPdfModeUseAttachments

OpenAction (typ TXLSPDFOpenAction) väljer läsarens inledande beteende med xlsPdfOpenNone, xlsPdfOpenPageeller xlsPdfOpenOutlines. För xlsPdfOpenPageär OpenActionPage målsidan i enbaserad numrering (klippt till antalet sidor) och OpenActionZoom den inledande förstoringsfaktorn, där 0 behåller läsarens standardzoom eller anpassning

Gemensam adaptiv vektorgeometri

XLSBuildEllipticArcCubics omvandlar en ellipsbåge till kubiska Bezier-segment genom att rekursivt upprätthålla en anroparvald platthetsgräns; PDF-, SVG- och bitmappsrendering använder den här gemensamma geometrin så att stora eller starkt excentriska bågar får fler segment utan att enkla bågar bestraffas

XLSDecodeVectorScene validerar EMF- och WMF-huvuden, postjustering och poststorlekar, deklarerade totaler, exakt EOF-placering och resursgränser utan att anropa plattformens metafiluppspelning; den inbyggda vitlistan spelar upp enhetskontextens tillståndsstackar med spara och återställ, fönster- och visportmappning kombinerad med världstransformationer, objekttabeller för penna, pensel och utökad penna inklusive standardobjekt, rektanglar, ellipser, linjekedjor, polygoner, polylinjer och Bezier-kurvor med streckstilar, sökvägsklamrar med fyllning, streckning och kombinerad streck-och-fyllningspass, avrundade rektanglar, bågar, kordor, cirkelsektorer och vinkelbågar via exakt båge-till-Bezier-konvertering, områdesfyllningar och ramar från avgränsade RGNDATA-rektanglar, avgränsade textkörningar med teckensnitt, färger och justering samt begränsade stretch-DIB-bilder som kodas om till PNG via Canvas och SVG, avvisar escape-poster och lämnar klippning och privata poster till den befintliga avgränsade reservvägen

PDF-outlines och sidocallbacks

PDF-outlines finns i samlingen Bookmarks (typ TXLSPDFBookmarks): Add och AddForSheet lägger till poster, Delete tar bort en, och Count med Items uppräknar trädet. Varje TXLSPDFBookmark -post stöder över- och underordnade poster (Children), syskonkedjor, Unicode-titlar, färger (Color), ett PageNumber -mål, källans SheetName för kalkylbladsbokmärken samt fet- och kursivflaggor (en mängd av TXLSPDFBookmarkStyle: xlsPdfBookmarkBold, xlsPdfBookmarkItalic), plus expanderade eller komprimerade underliggande poster; automatiska kalkylbladsbokmärken använder samma hierarkimodell och AutoSheetBookmarks styr om de genereras

BeforeNewPage kan justera varje sidruta, medan BeforeGeneratePage och AfterGeneratePage ritar bakgrunds- eller överläggsinnehåll via de offentliga sidhjälpfunktionerna AppendPageContent, FillPageRectangle, StrokePageRectangleoch DrawPageText

Signaturer och bilagor

TXLSPDFSignature konfigurerar synliga eller osynliga signaturfält, medan CertificationPolicy valfritt skapar en DocMDP-certifieringssignatur som tillåter inga ändringar, ifyllning och signering av formulär, eller ifyllning, signering och anteckningar; PDF/A-1 tillåter inte den här PDF 1.5-funktionen och avvisas innan utdata bekräftas

TXLSPDFCertificationPolicy tillhandahåller xlsPdfApprovalSignature, xlsPdfCertifyNoChanges, xlsPdfCertifyFormFillingAndSigningoch xlsPdfCertifyFormFillingSigningAndAnnotations för att välja signaturpolicyn explicit

En TXLSPDFSignDigestEvent tar emot sammandraget och returnerar värdskapad CMS-data, så HotXLS behöver aldrig en privat nyckel

TXLSPDFExport.Signature kopplar signaturkonfigurationen, och PDF/A-3-profiler kan inkludera validerade associerade filer via AddAttachment, som köar en TXLSPDFAttachment; den detaljerade överlagringen accepterar ett Unicode-visningsnamn, MIME-typ, beskrivning, ändringstid, nyttolast och ett TXLSPDFAttachmentRelationship -värde av Source, Data, Alternative, Supplement eller Unspecified, medan AttachmentCount rapporterar antalet köade och AttachmentDuplicatePolicy (typ TXLSPDFAttachmentDuplicatePolicy) väljer hur lika namn hanteras

TXLSPDFSignature.ImageData, ImageFormatoch ImageFit (typ TXLSPDFSignatureImageFit: contain, cover eller stretch) placerar en PNG i det normala utseendeformuläret innan byte range:n frysas; contain-, cover- och stretchlägena delar dokumentets bildcache, medan ogiltiga bilder misslyckas före signeringen

Överlagringen IXLSPDFAttachmentSource förblir lat fram till sparandet, anropar varje källa en gång per sparning och spolar ut högst 256 MiB innan EmbeddedFile-objektet skapas, så att leverantörsfel lämnar destinationstransaktionen oförändrad

Slutmonteringen skriver objekt sekventiellt till destinationen i stället för att bygga en dokumentomfattande sträng: osignerade exporter streamar rakt in i framåtriktade strömmar, varje EmbeddedFile refererar sin byte-storlek via ett indirekt /Length -objekt som skrivs ut efter nyttolasten, och leverantörsbyte kopieras från spoolen i fasta bitar; signerade exporter monteras i en avgränsad dokumentspool som tar emot ByteRange - och signaturinnehållspatchar, en inkrementell SHA-256 över de två täckta intervallen och en enda framåtriktad kopia

PDF/A-3-utdata skriver varje associerad fil till både namnträdet EmbeddedFiles och katalogens AF-array, med ett Unicode- UF -namn, ett escapat MIME-PDF-namn, AFRelationship, byte-storlek, valfritt ändringsdatum och valfri beskrivning; PDF/A-1 och PDF/A-2 avvisar köade bilagor innan utdata bekräftas

Dokumentmetadata

DocumentTitle, DocumentAuthor, DocumentSubject, DocumentKeywordsoch DocumentFileName fyller PDF:ens informations- och metadataordlistor

Teckensnittsreserv

TXLSPDFExport.SetFontFallbackChain, AddFontFallbackoch ClearFontFallbackChains konfigurerar reservnivåer specifika för källfamilj och stil; LoadedFallbackFontCount exponerar antalet cachelagrade teckensnittsytor och FontFallbackSelectionCacheCount antalet cachade reservbeslut per val, båda för diagnostik

TXLSPDFExport.FontSize ställer in standardtextstorleken i punkter, med 9 som standardvärde

Reservvalet använder glyfomfång och bevarar Unicode-mappningar, kompletterande skalärer, grafemkluster, formningskluster och fristående TTC-ytor

OnGetFontDirectories kan returnera en eller flera semikolonseparerade teckensnittskataloger för en begärd familj och stil; godtkomna kataloger genomsöks rekursivt en gång, indexeras via intern familje-/stilmetadata och cachas för efterföljande mätning och ritning

Policy för teckensnittsinbäddning

TXLSPDFExport.FontEmbedding (typ TXLSPDFFontEmbedding) väljer automatisk inbäddning, obligatorisk subsetting, det kompletta teckensnittsprogrammet eller map-only-utdata via xlsPdfFontEmbedAuto, xlsPdfFontEmbedSubset, xlsPdfFontEmbedFulloch xlsPdfFontEmbedNone; obligatorisk subsetting misslyckas atomärt när en giltig delmängd inte kan produceras, TTC-ytor konverteras till fristående teckensnitt, och PDF/A avvisar map-only-utdata

OnFontEmbed utlöses en gång per Unicode-yta innan dess mått, teckenkarta, formning och glyfidentifierare har lösts; sätts Handled accepteras det returnerade per-teckensnittsläget och valfria ersättningsbyte, medan det lämnas falskt behålls dokumentpolicyn och ursprungsytan

Fristående OpenType-teckensnitt med CFF-konturer bäddas in via FontFile3 med en OpenType -ström och en CIDFontType0 -efterföljare; automatiskt och fullständigt läge behåller det kompletta programmet, medan obligatorisk CFF-subsetting misslyckas atomärt eftersom den inte kan bevara en giltig delmängd

Inbäddade teckensnitt som bär OpenType GPOS - eller äldre kern -data använder positionerade glyfavstånd för enkel och komplex text, så att mätning, radbrytning, justering och utskrivna glyfpositioner delar samma kerningresultat

Förlopp och avbrytande

TXLSPDFExport.OnProgress och OnProgressEx rapporterar start-, sida- och slutfaser; Cancel begär avbrytande, och Aborted rapporterar slutstatusen utan att bekräfta en delvis ström

Se även

• TXLSPaginationModel
• SaveAsPDF
• Avancerade arbetsboksarbetsflöden