Avancerade XLSX-API-medlemmar
Dessa medlemmar täcker mindre vanliga men offentliga XLSX-redigeringsytor som kompletterar de primära referenssidorna för arbetsbok, arbetsblad, intervall, stil, filter och diagram
Arbetsbladsrutor, visning och bakgrund
TXLSXWorksheet.SplitPanes och RemoveSplit redigerar tillståndet för delade rutor; SplitRow, SplitCol, PaneStateKind och ScrollCol exponerar de lagrade vykoordinaterna
DisplayRowColHeaders styr rad- och kolumnrubriker, GridLinesSet skiljer ett explicit rutnätsval från standardvärdet, och DefaultFormat plus StyleOverlays exponerar stilstatus på bladnivå
BackgroundImageData och BackgroundImageFormat exponerar arbetsbladets bakgrundsbild, BackgroundImageResource tillhandahåller en backendsneutral skrivskyddad nyttolast med formatbeskrivning, och ClearBackgroundImage tar bort den
Panelmarkeringar och rullning
GetSelectedAreas och den panelförsta SelectAreas-överlagringen använder den gemensamma typen TXLSPanePosition, bevarar ordnade och överlappande A1-områden och returnerar anropsägda ögonblicksbilder med aktiv områdesindex
Strukturella redigeringar av hela rader och kolumner mappar om varje panelmarkering, bevarar överlevande ordning och aktiv områdesidentitet, och använder deterministiska efterföljare, föregångare eller gränsceller som fallback när det aktiva området tas bort
Normalisering av markering, strukturell omappning och uppskapande av ögonblicksbilder använder engångsbyggare och geometrisk kapacitetsväxt för amorterat linjär hantering av stora områden
TryGetWindowScroll och ScrollWindow använder samma logiska paneler och 1-baserade koordinater medan övergripande sheetView samt nedre/högra pane-rullningspositioner behålls oberoende
Saknade paneler och ogiltiga uppdateringar lämnar kalkylbladet oförändrat; se Panelmarkeringar och rullning i kalkylblad
Intervall som hålls samman vid paginering
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether och KeepTogetherCount definierar block som bör förbli på en sida där geometrin tillåter det
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow och KeepColBlockBreakCol inspekterar hur föreslagna sidbrytningar interagerar med dessa block
Hjälpfunktioner för arbetsbladsredigering
AddImagePair skriver en primär bild plus en reservkompanjon som SVG och PNG, AddChartFromRanges bygger ett diagram från typsatta kategori- och värdeintervall, och CheckDataValidations returnerar varje överträdande cell
CheckDataValidation testar ett kandidatvärde mot varje valideringsregel som täcker en cell, returnerar -1 när det är giltigt eller det 1-baserade indexet för den första underkända regeln, och kan valfritt genomföra bara en giltig kandidat
GetCellVisibleFormat slår upp den effektiva formateringen för kalkylblad, rad, kolumn, områdesöverlägg och explicit cell utan att skapa en tom cell; Subtotal grupperar ett sorterat intervall efter förändringar i en kolumn och infogar delsummeformler, valfria totalsummeformler, ärvd formatering och disposationsnivåer
SortRangeInternal är den avancerade stabila sorteringsstartpunkten som används av intervall- och rapportoperationer; anropare bör normalt föredra SortRange eller TXLSXRange.Sort
ClearColWidth och ClearRowHeight tar bort en kolumns eller rads explicita dimension så att den faller tillbaka på bladstandard, som komplement till kontrollerna HasColWidth / HasRowHeight
Styrning av disponationsnoder
TryGetOutlineNode returnerar den riktningskänsliga summeringsnoden, detaljområdet, disposationsnivån, doldläget och den explicita kollapsmarkören för ett 1-baserat rad- eller kolumnindex
SetOutlineNodeCollapsed kollapsar eller expanderar idempotent en summeringsnod, medan SetOutlineDisplayLevel tillämpar den 1-baserade disponationsnivån över varje materialiserad grupp; båda accepterar xocPreserve, xocCollapse eller xocExpand som hantering av barn
ToggleRowGrouped och ToggleColGrouped är kompatibilitetsomslag som tar emot första detaljindexet och löser den verkliga summeringsnoden från SummaryBelow eller SummaryRight
Grupper av rader och kolumner i nativa OpenDocument-dokument mappas via table:display, överlever direkta metadata- och strukturediteringar och konverteras till XLSX-markörer för summeringsnoder utan att medlemsnivå-kollapsflaggor behålls; se Gles disposationsgeometri
Namngivna stilar och uppslagning av tabellstilar
TXLSXRange.ApplyNamedStyle länkar ett område till en namngiven cellstil; TXLSXLinkedStyle.AutomaticChoose härleder de berörda formatdelarna från stilen, medan LinkedParts väljer typsnitt, fyllning, ram, talformat, justering eller skydd uttryckligen
Redigering av TXLSXNamedStyle.Style uppdaterar länkade delar utan att kassera lokala åsidosättningar, och GetCellVisibleFormat slår upp resultatet tillsammans med kalkylbladsöverlägg och tabellstilar utan att materialisera tomma celler
TXLSXNamedStyles.FindByName hittar en namngiven stilpost på dess visningsnamn utan att samlingen behöver sökas igenom manuellt
Alla 60 inbyggda tabellstilsnamn — ljusa, medel och mörka — slås upp till kompletta temabaserade sektionsformat som delas av HTML-, PDF-, bild-, förhandsgransknings- och viewer-utdata
Formelkonvertering
TXLSXCell.ConvertFormulaToValue ersätter en formel med dess cachelagrade värde och TXLSXCells.ConvertFormulasToValues tillämpar samma operation på den lagrade cellsamlingen
Validering av formelinmatning
TXLSXWorkbook.FormulaEntryPolicy och TXLSXWorksheet.ValidateFormulaEntry exponerar det gemensamma, tillståndsfria kontraktet för formelinmatning, skiljer på tom text, okända funktioner, okända namn, syntaxfel och ogiltiga mål, och känner igen registrerade användarfunktioner utan att anropa dem; se Policy för validering av formelinmatning
Celldiagnostik för lagring
TXLSXCells.PackedStorageEnabled styr den packade RLE-backend som används av kompatibla radordnade typade bulkskrivningar, och PackedCellCount rapporterar cellerna som lagras där innan objektnivååtkomst materialiserar stabila cellhandtag
GetStorageStatistics rapporterar radblock, ifyllda rader, byte för objekt, text, formler, rich text, uppskattat packat, aktivt packat, allokerat, använt samt packade strängar för mätbara minnesbeslut; räkningen av stilnyttolaster och undvikida byte för formaterade tomma celler exponerar kopiera-vid-skriv-delning direkt
Autofilterdetaljer
TXLSXAutoFilterColumn.ClearValueFilters rensar värde- och datumgruppsfilter samtidigt som kolumnposten behålls
HasCriteria2 och AndConnector beskriver anpassade filter med två villkor; färgfilter använder HasColorFilter, HasColorFilter_CellColor och HasColorFilter_DxfId; ikonfilter använder HasIconFilter, HasIconFilter_Set och HasIconFilter_Id
Dynamiska filter använder HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal och HasDynamicFilter_MaxValSet; RawXml bevarar ostödd filter-nyttolast
Gradientfyllningar
TXLSXFill.AddGradientStop lägger till ett färgstopp. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount och GradientStops exponerar linjär- eller banageometri
BackgroundColorTheme, BackgroundColorIndex och BackgroundTintAndShade bevarar icke-RGB-bakgrundsfärger, och TXLSXFills.AddLinearGradient skapar och registrerar en komplett linjär gradient
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex och ForegroundTintAndShade är motsvarigheterna i förgrunden och bevarar tema-, palettindex- och toningsfärger i förgrunden bredvid RGB-värdet
Diagram
TXLSXChart exponerar PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly och fasaden DataLabelsRange för kompatibilitet, vars sättare sprider till aktuella serier och förbereder senare serier medan dess hämtare bara returnerar en gemensam formel per serie
TXLSXChartPlotGroup.Assign kopierar en plotgrupp; ZOrder, BarGrouping, GapWidth och Overlap styr dess ordning och stolpgeometri
TXLSXChartSeries exponerar SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos och LabelPosSet
Cellbaserade etiketter per serie använder DataLabelsRange, DataLabelsCache, ShowDataLabelsRange och ShowDataLabelsRangeSet; SetPointShowDataLabelsRange och TryGetPointShowDataLabelsRange underhåller glesa, nollbaserade åsidosättningar av synlighet, medan ResolveDataLabelsRange uppdaterar tillgänglig kalkylbladstext en gång per arbetsboksgeneration och behåller externa cacher utan att öppna en datakälla
TXLSXChartSeries.CategoriesMultiLevel emitterar c:multiLvlStrRef-kategorier för hierarkiska axeletiketter, medan standardvärdet behåller den platta c:strRef / c:numRef-emitteringen
TXLSXChartTrendline exponerar Intercept, InterceptSet, Forward och Backward som prognosperioder, medan TXLSXChartAxis.ShowDispUnitsLabel styr etiketten för visningsenheter
Villkorliga format och valideringar
TXLSXConditionalFormat.ContainsCellFast utför indexerade medlemskontroller, HasStyle rapporterar en differentialstil, och StdDev, EqualAverage och IsPivot exponerar avancerade regelflaggor
TXLSXConditionalFormat.AcquireWriteGuard returnerar arbetsbokens IXLSWorkbookWriteGuard så att batchade regeländringar flyttar fram arbetsboksgenerationen en gång vid fullbordan
TXLSXDataValidation.ContainsCellFast utför motsvarande indexerade medlemskontroll för valideringsintervall
Tabeller, blad, länkar, kommentarer och ritobjekt
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds och HasHeaderRow bevarar frågestödd och rubrikfri tabellmetadata
TXLSXTable.FindFirst och FindNext söker av ett anropat kalkylblad efter rader vars namngivna kolumn är lika med ett värde och returnerar en 1-baserad rad eller 0, med skiftlägesokänslig jämförelse av strängar, tal och booleska värden
TXLSXSheets.AddCopy duplicerar ett arbetsblad med beroende objekt och ByPos får åtkomst till samlingen efter aktuell flikposition
TXLSXExternalLink.AddDefinedName och DefinedNameCount underhåller cachelagrade externa namn och FindDefinedName hittar en post på namn; de skrivskyddade egenskaperna RelationshipId, SourceSlot och LinkKind exponerar relations-id:t för den externa länkdelen, den 1-baserade [N]-platsen som externa formler använder och länkklassificeringen (arbetsbok, DDE, OLE eller okänd); TXLSXHyperlink.TargetFrame bevarar målbläddringskontexten
TXLSXDefinedName.UnknownAttributes bevarar okända attribut på ett definierat namn så att ej stödda tillägg överlever roundtrips
TXLSXComment.AutoSizeFromText storlekssätter kommentarsformen efter dess text och ClearFont tar bort explicita rika textfontkörningar
TXLSXImage.SvgData lagrar SVG-kompanjonen och CameraRange identifierar ett källintervall för länkad bild; TXLSXTextBox.PrstToken bevarar DrawingML-förinställningens geometritoken
Bilder delar nyttolaster utan att kopiera byte: tilldelning av TXLSXImage.Blob (gränssnittet IXLSXImageBlob med Data, SvgData, CacheKey, ContentDigest, SvgContentDigest och ByteSize) är den zerokopierade vägen för återkommande rapportbilder, kontrollsummorna beräknas en gång för mediesammanslagning vid sparning, och de skrivskyddade TXLSXImage.CacheKey och ContentDigest rapporterar den tilldelade identiteten; rapportcachen avvisar en cachenyckel som återanvänds med andra byte eller format
DrawingObjectCount och DrawingObject exponerar en stabil blandad ordning över bilder, diagram, textrutor, bevarade råa ankare och grupper; varje TXLSXDrawingObject exponerar Kind, Parent, ChildCount och TextBox och kan ordnas om med BringToFront, SendToBack, BringForward och SendBackward
GroupDrawingObjects skapar en transformkänslig DrawingML-grupp från valda objekt och UngroupDrawingObject återställer dess barn i ordning, inklusive grupper som lästs från ett befintligt paket
Motsvarigheter för klassiska arbetsblad
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage och BackgroundImageResource skapar, tar bort och granskar BIFF8-arbetsbladsbakgrunder; bitmapdata exponeras som en standard-BMP, nativa eller okända format behåller sin råa nyttolast och formatkod, och kända bakgrunder konverterar i båda riktningarna mellan Classic- och XLSX-motorerna
TXLSWorksheet.ConvertFormulasToValues ersätter formler med cachelagrade resultat, OpenRTF-överlagringarna importerar en RTF-tabell vid standardmålet eller ett anropat valt mål, WriteAutoValue väljer en celltyp från en variant, och DefaultFormat exponerar arbetsbladets standard-XF