Avancerede XLSX-API-medlemmer
Disse medlemmer dækker de mindre almindelige, men offentlige XLSX-redigeringsoverflader, som supplerer referencesiderne for projektmappe, regneark, område, typografi, filter og diagram
Regnearksruder, visning og baggrund
TXLSXWorksheet.SplitPanes og RemoveSplit redigerer tilstanden for delte ruder; SplitRow, SplitCol, PaneStateKind og ScrollCol viser de gemte visningskoordinater
DisplayRowColHeaders styrer række- og kolonneoverskrifter, GridLinesSet adskiller et eksplicit gitterlinjevalg fra standarden, og DefaultFormat plus StyleOverlays viser stil-tilstanden på arkniveau
BackgroundImageData og BackgroundImageFormat eksponerer regnearkets baggrundsbillede, BackgroundImageResource leverer en backend-neutral, skrivebeskyttet payload og formatbeskrivelse, og ClearBackgroundImage fjerner det
Rudevalg og rulning
GetSelectedAreas og den rude-første SelectAreas-overload bruger den delte type TXLSPanePosition, bevarer ordnede og overlappende A1-områder og returnerer caller-ejede snapshots med det aktive områdeindeks
Strukturelle redigeringer af hele rækker og kolonner genafbilleder hver rudevalg, bevarer den overlevende rækkefølge og den aktive områdes identitet og bruger deterministisk efterfølger-, forgænger- eller grænsecelle-fallback, når det aktive område fjernes
Markeringnormalisering, strukturel genafbildning og snapshot-opbygning bruger one-pass-byggere og geometrisk kapacitetsvækst til amortiseret lineær behandling af store områder
TryGetWindowScroll og ScrollWindow bruger de samme logiske ruder og 1-baserede koordinater, mens den overordnede sheetView og den nedre/højre pane-rulleposition bevares uafhængigt
Manglende ruder og ugyldige opdateringer efterlader regnearket uændret; se API til rudevalg i regneark
Pagerings-hold-sammen-intervaller
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether og KeepTogetherCount definerer blokke, der skal forblive på én side, hvor geometrien tillader det
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow og KeepColBlockBreakCol inspicerer, hvordan foreslåede sideskift interagerer med disse blokke
Hjælpefunktioner til regnearksredigering
AddImagePair skriver et primært billede plus en fallback-følgesvend som SVG og PNG, AddChartFromRanges bygger et diagram ud fra typede kategori- og værdiintervaller, og CheckDataValidations returnerer hver krænkende celle
CheckDataValidation tester én kandidatværdi mod hver valideringsregel, der dækker en celle, returnerer -1, når den er gyldig, eller indekset (1-baseret) på den første regel, der fejler, og kan valgfrit kun gemme en gyldig kandidat
GetCellVisibleFormat opløser den effektive formatering fra regneark, række, kolonne, område-overlay og eksplicit celleformatering uden at oprette en tom celle; Subtotal grupperer et sorteret område efter ændringer i én kolonne og indsætter deltotalformler, valgfrie stortotalformler, nedarvet formatering og disposisionsniveauer
SortRangeInternal er det avancerede stabile sorteringsindgangspunkt, der bruges af interval- og rapportoperationer; kaldere bør normalt foretrække SortRange eller TXLSXRange.Sort
ClearColWidth og ClearRowHeight fjerner én kolonnes eller rækkes eksplicitte dimension, så den falder tilbage til arkenes standard, og supplerer proberne HasColWidth / HasRowHeight
Styring af disposisionsnoder
TryGetOutlineNode returnerer den retningsbevidste opsummeringsnode, detaljeområdet, disposisionsniveauet, skjult-tilstanden og den eksplicitte kollapsmarkering for et 1-baseret række- eller kolonneindeks
SetOutlineNodeCollapsed kollapser eller udfolder idempotent én opsummeringsnode, mens SetOutlineDisplayLevel anvender det 1-baserede dispositionsknapniveau på alle materialiserede grupper; begge accepterer xocPreserve, xocCollapse eller xocExpand som håndtering af børn
ToggleRowGrouped og ToggleColGrouped forbliver kompatibilitetswrappere, der accepterer det første detaljeindeks og opløser den faktiske opsummeringsnode fra SummaryBelow eller SummaryRight
Indfødte OpenDocument række- og kolonnegrupper afbilledes via table:display, overlever direkte metadata- og strukturelle redigeringer og konverteres til XLSX-markører for opsummeringsnoder uden at bevare kollapsflag på medlemsniveau; se Sparsom dispositiongeometri
Navngivne typografier og tabeltypografi-opløsning
TXLSXRange.ApplyNamedStyle lænker et område til en navngiven celletypografi; TXLSXLinkedStyle.AutomaticChoose udleder de berørte formatdele fra typografien, mens LinkedParts vælger skrifttype, udfyldning, kant, talformat, justering eller beskyttelse eksplicit
Redigering af TXLSXNamedStyle.Style opdaterer de lænkede dele uden at kassere lokale overskrivelser, og GetCellVisibleFormat opløser resultatet sammen med regnearks-overlays og tabeltypografier uden at materialisere tomme celler
TXLSXNamedStyles.FindByName finder en navngiven typografipost via dens visningsnavn uden at scanne samlingen manuelt
Alle 60 indbyggede light-, medium- og dark-tabeltypografinavne opløses til komplette temabaserede sektionsformater, som HTML-, PDF-, billede-, forhåndsvisnings- og viewer-output deler
Formelkonvertering
TXLSXCell.ConvertFormulaToValue erstatter én formel med dens cachede værdi, og TXLSXCells.ConvertFormulasToValues anvender samme operation på den gemte cellesamling
Validering af formelindtastning
TXLSXWorkbook.FormulaEntryPolicy og TXLSXWorksheet.ValidateFormulaEntry eksponerer den delte mutationsfri kontrakt for formelindtastning, adskiller tom tekst, ukendte funktioner, ukendte navne, syntaksfejl og ugyldige mål og genkender registrerede brugerfunktioner uden at kalde dem; se Politik for validering af formelindtastning
Cellelager-diagnostik
TXLSXCells.PackedStorageEnabled styrer den pakkede RLE-backend, der bruges af kompatible typede bulk-skrivninger med rækker først, og PackedCellCount rapporterer de celler, der opbevares dér, før adgang på objektniveau materialiserer stabile celle-handles
GetStorageStatistics rapporterer rækkeblokke, udfyldte rækker samt objekt-, tekst-, formel-, rich-text-, estimeret pakkede, aktive pakkede, allokerede, brugte og pakkede streng-byte-tal til målbare hukommelsesbeslutninger; optælling af typografi-payloads og undgåede bytes for typografi-tomme celler viser copy-on-write-delingen direkte
AutoFilter-detaljer
TXLSXAutoFilterColumn.ClearValueFilters rydder værdi- og datogruppefiltrene, mens kolonneposten bevares
HasCriteria2 og AndConnector beskriver brugerdefinerede filtre med to betingelser; farvefiltre bruger HasColorFilter, HasColorFilter_CellColor og HasColorFilter_DxfId; ikonfiltre bruger HasIconFilter, HasIconFilter_Set og HasIconFilter_Id
Dynamiske filtre bruger HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal og HasDynamicFilter_MaxValSet; RawXml bevarer ikke-understøttet filterpayload
Gradientudfyldninger
TXLSXFill.AddGradientStop tilføjer en farvestop. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount og GradientStops viser lineær eller stigeometri
BackgroundColorTheme, BackgroundColorIndex og BackgroundTintAndShade bevarer ikke-RGB-baggrundsfarver, og TXLSXFills.AddLinearGradient opretter og registrerer en komplet lineær gradient
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex og ForegroundTintAndShade er forgrundspartnernerne og bevarer tema-, paletindeks- og tint-and-shade-forgrundsfarver ved siden af RGB-værdien
Diagrammer
TXLSXChart eksponerer PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly og kompatibilitetsfacaden DataLabelsRange, hvis setter udbreder til aktuelle serier og forudindstiller senere serier, mens getteren kun returnerer en fælles pr. serie-formel
TXLSXChartPlotGroup.Assign kopierer en plotgruppe; ZOrder, BarGrouping, GapWidth og Overlap styrer dens rækkefølge og stængergeometri
TXLSXChartSeries viser SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos og LabelPosSet
Cellerkoblede labeler pr. serie bruger DataLabelsRange, DataLabelsCache, ShowDataLabelsRange og ShowDataLabelsRangeSet; SetPointShowDataLabelsRange og TryGetPointShowDataLabelsRange vedligeholder sparsomme, 0-baserede synlighedsoverskrivelser, mens ResolveDataLabelsRange opfrisker tilgængelig regnearkstekst én gang pr. projektmappegeneration og bevarer eksterne caches uden at åbne en datakilde
TXLSXChartSeries.CategoriesMultiLevel emitterer c:multiLvlStrRef-kategorier til hierarkiske akselabels, mens standarden beholder den flade c:strRef / c:numRef-emission
TXLSXChartTrendline eksponerer Intercept, InterceptSet, Forward og Backward som prognoseperioder, mens TXLSXChartAxis.ShowDispUnitsLabel styrer labelen for visningsenhederne
Betingede formater og valideringer
TXLSXConditionalFormat.ContainsCellFast udfører indekserede medlemskabstjek, HasStyle rapporterer en differential-stil, og StdDev, EqualAverage og IsPivot viser avancerede regelflag
TXLSXConditionalFormat.AcquireWriteGuard returnerer projektbogens IXLSWorkbookWriteGuard, så batchede regelredigeringer fremrykker projektmappe-generationen én gang ved fuldførelse
TXLSXDataValidation.ContainsCellFast udfører det tilsvarende indekserede medlemskabstjek af valideringsområdet
Tabeller, ark, links, kommentarer og tegninger
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds og HasHeaderRow bevarer forespørgselsbaserede og overskriftsløse tabelmetadata
TXLSXTable.FindFirst og FindNext scanner et af kalderen leveret regneark efter rækker, hvis navngivne kolonne er lig en værdi, og returnerer en 1-baseret række eller 0, med versaluafhængige streng-, tal- og booleske sammenligninger
TXLSXSheets.AddCopy duplikerer et regneark med dets afhængige objekter, og ByPos tilgår samlingen efter aktuelle faneposition
TXLSXExternalLink.AddDefinedName og DefinedNameCount vedligeholder cachede eksterne navne, og FindDefinedName finder én post efter navn; de skrivebeskyttede egenskaber RelationshipId, SourceSlot og LinkKind eksponerer relations-id'et for den eksterne link-del, den 1-baserede [N]-plads, som eksterne formler bruger, og linkets klassifikation (projektmappe, DDE, OLE eller ukendt); TXLSXHyperlink.TargetFrame bevarer mål-browsing-konteksten
TXLSXDefinedName.UnknownAttributes bevarer ukendte attributter på et defineret navn, så ikke-understøttede udvidelser overlever round-trips
TXLSXComment.AutoSizeFromText størrelsessætter kommentarfiguren efter dens tekst, og ClearFont fjerner eksplicitte skriftype-runs i rich text
TXLSXImage.SvgData gemmer SVG-følgesvenden, og CameraRange identificerer et linket-billede-kildeinterval; TXLSXTextBox.PrstToken bevarer DrawingML-forudindstillet geometritoken
Billeder deler payloads uden at kopiere bytes: tildeling af TXLSXImage.Blob (interfacet IXLSXImageBlob med Data, SvgData, CacheKey, ContentDigest, SvgContentDigest og ByteSize) er zero-copy-vejen for gentagne rapportbilleder, digestene beregnes én gang til medieinterning ved gemning, og de skrivebeskyttede TXLSXImage.CacheKey og ContentDigest rapporterer den tildelte identitet; rapport-cachen afviser én cache-nøgle, der genbruges med andre bytes eller formater
DrawingObjectCount og DrawingObject eksponerer én stabil, blandet rækkefølge på tværs af billeder, diagrammer, tekstbokse, bevarede rå ankre og grupper; hvert TXLSXDrawingObject eksponerer Kind, Parent, ChildCount og TextBox og kan omorganiseres med BringToFront, SendToBack, BringForward og SendBackward
GroupDrawingObjects opretter en transformbevidst DrawingML-gruppe af de udvalgte objekter, og UngroupDrawingObject gendanner dens børn i rækkefølge, også for grupper indlæst fra en eksisterende pakke
Klassiske regnearksmodstykker
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage og BackgroundImageResource opretter, fjerner og inspicerer BIFF8-regnearksbaggrunde; bitmapdata eksponeres som standard-BMP, indfødte eller ukendte formater bevarer deres rå payload og formatkode, og kendte baggrunde konverterer i begge retninger mellem den klassiske og XLSX-motoren
TXLSWorksheet.ConvertFormulasToValues erstatter formler med cachelagrede resultater, OpenRTF-overloads importerer en RTF-tabel ved standardmålet eller et kaldervalgt mål, WriteAutoValue vælger en celletype fra en variant, og DefaultFormat viser regnearkets standard-XF