Geavanceerde XLSX-API-leden
Deze leden bestrijken minder voorkomende maar openbare XLSX-bewerkingsoppervlakken die de primaire referentiepagina's voor werkmap, werkblad, bereik, stijl, filter en grafiek aanvullen
Werkbladvensters, weergave en achtergrond
TXLSXWorksheet.SplitPanes en RemoveSplit bewerken de status van gesplitste vensters; SplitRow, SplitCol, PaneStateKinden ScrollCol stellen de opgeslagen weergavecoördinaten bloot
DisplayRowColHeaders regelt rij- en kolomkoppen, GridLinesSet onderscheidt een expliciete rasterlijnkeuze van de standaard, en DefaultFormat plus StyleOverlays stellen stijlstatus op bladniveau bloot
BackgroundImageData and BackgroundImageFormat en BackgroundImageResource stellen de achtergrondafbeelding van het werkblad bloot, terwijl ClearBackgroundImage deze verwijdert
Paneelselecties en scrollen
GetSelectedAreas en de paneel-eerste SelectAreas -overload gebruiken het gedeelde type TXLSPanePosition , behouden geordende en overlappende A1-gebieden en geven momentopnamen in beheer van de aanroeper terug met de index van het actieve gebied
Structurele bewerkingen van hele rijen en kolommen mappen elke paneelselectie opnieuw, behouden de overgebleven volgorde en de identiteit van het actieve gebied, en gebruiken deterministische opvolger-, voorganger- of grenscel-fallbacks wanneer het actieve gebied is verwijderd
Normalisatie van selecties, structurele remapping en het bouwen van momentopnamen gebruiken one-pass-builders en geometrische capaciteitsgroei voor amortized-lineaire verwerking van grote gebieden
TryGetWindowScroll en ScrollWindow gebruiken dezelfde logische panelen en op 1 gebaseerde coördinaten, terwijl de totale sheetView en de scrollposities van het onderste of rechter pane onafhankelijk blijven
Ontbrekende panelen en ongeldige updates laten het werkblad ongewijzigd; zie Worksheet pane selections and scrolling
Paginering: bijeenhouden-bereiken
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogetheren KeepTogetherCount definiëren blokken die waar de geometrie het toestaat op één pagina moeten blijven
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRowen KeepColBlockBreakCol inspecteren hoe voorgestelde pagina-einden met die blokken samenwerken
Helpers voor het bewerken van werkbladen
AddImagePair schrijft een primaire afbeelding plus een terugvalbegeleider zoals SVG en PNG, AddChartFromRanges bouwt een grafiek uit getypeerde categorie- en waardereeksen, en CheckDataValidations retourneert elke cel die een validatie schendt
CheckDataValidation toetst één kandidaatwaarde aan elke validatieregel die een cel bestrijkt, geeft -1 terug wanneer die geldig is of de op 1 gebaseerde index van de eerst mislukte regel, en legt optioneel alleen een geldige kandidaat vast
GetCellVisibleFormat herleidt de effectieve opmaak van werkblad, rij, kolom, bereik-overlay en expliciete cel, zonder een lege cel aan te maken; Subtotal groepeert een gesorteerd bereik op wijzigingen in één kolom en voegt subtotalformules, optionele grand-total-formules, overgeërfde opmaak en outline-niveaus in
SortRangeInternal is het geavanceerde stabiele-sorteertoegangspunt dat door bereik- en rapportbewerkingen wordt gebruikt; aanroepers moeten normaal gesproken de voorkeur geven aan SortRange of TXLSXRange.Sort
ClearColWidth en ClearRowHeight verwijderen de expliciete afmeting van één kolom of rij, zodat die terugvalt op de bladstandaard; een aanvulling op de probes HasColWidth / HasRowHeight probes
Outline-knooppuntbesturing
TryGetOutlineNode geeft het richtingsbewuste samenvattingsknooppunt, het detailbereik, het outlineniveau, de verborgen status en de expliciete inklapmarkering terug voor een op 1 gebaseerde rij- of kolomindex
SetOutlineNodeCollapsed klapt één samenvattingsknooppunt idempotent in of uit, terwijl SetOutlineDisplayLevel het op 1 gebaseerde outline-knopniveau toepast op elke g materialiseerde groep; beide accepteren xocPreserve, xocCollapseof xocExpand voor de afhandeling van kinderen
ToggleRowGrouped en ToggleColGrouped blijven compatibiliteitswrappers die de eerste detailindex accepteren en het werkelijke samenvattingsknooppunt afleiden uit SummaryBelow of SummaryRight
Native OpenDocument-rij- en kolomgroepen worden via table:displaygemapped, overleven directe metadata- en structurele bewerkingen, en worden naar XLSX-samenvattingsknooppuntmarkeringen geconverteerd zonder vlaggen voor inklappen op ledeniveau; zie Sparse outline geometry
Named styles en tabelstijlherleiding
TXLSXRange.ApplyNamedStyle koppelt een bereik aan een benoemde celstijl; TXLSXLinkedStyle.AutomaticChoose leidt de betrokken opmaakonderdelen af uit de stijl, terwijl LinkedParts lettertype, vulling, rand, getalnotatie, uitlijning of beveiliging expliciet kiest
Bij het bewerken van TXLSXNamedStyle.Style worden gekoppelde onderdelen bijgewerkt zonder lokale overrides weg te gooien, en GetCellVisibleFormat herleidt het resultaat samen met werkblad-overlays en tabelstijlen, zonder lege cellen te materialiseren
TXLSXNamedStyles.FindByName lokaliseert een benoemde stijlentry op zijn weergavenaam, zonder de collectie handmatig te doorzoeken
Alle 60 ingebouwde light-, medium- en dark-tabelstijlnamen herleiden naar complete themagebaseerde sectieopmaak die wordt gedeeld door HTML-, PDF-, afbeeldings-, voorbeeld- en viewer-uitvoer
Formuleconversie
TXLSXCell.ConvertFormulaToValue vervangt één formule door de gecachte waarde en TXLSXCells.ConvertFormulasToValues past dezelfde bewerking toe op de opgeslagen celverzameling
Validatie van formule-invoer
TXLSXWorkbook.FormulaEntryPolicy en TXLSXWorksheet.ValidateFormulaEntry tonen het gedeelde mutatievrije contract voor formule-invoer, onderscheiden lege tekst, onbekende functies, onbekende namen, syntaxfouten en ongeldige doelen, en herkennen geregistreerde gebruikersfuncties zonder die aan te roepen; zie Formula entry validation policy
Celopslagdiagnostiek
TXLSXCells.PackedStorageEnabled stuurt de packed-RLE-backend die door compatibele typed bulkbewerkingen in rij-major-volgorde wordt gebruikt, en PackedCellCount rapporteert de cellen die daar bewaard worden voordat toegang op objectniveau stabiele celhandles materialiseert
GetStorageStatistics rapporteert rijblokken, gevulde rijen en bytetellingen voor objecten, tekst, formules, rich text, geschatte packed, actieve packed, toegewezen, gebruikte en packed-string-opslag, zodat het geheugengebruik meetbaar is; tellingen van stijl-payloads en vermeden bytes voor opgemaakte lege cellen tonen copy-on-write-deling direct
AutoFilter-details
TXLSXAutoFilterColumn.ClearValueFilters wist waarde- en datagroepsfilters terwijl de kolominvoer behouden blijft
HasCriteria2 en AndConnector beschrijven aangepaste filters met twee voorwaarden; kleurfilters gebruiken HasColorFilter, HasColorFilter_CellColoren HasColorFilter_DxfId; pictogramfilters gebruiken HasIconFilter, HasIconFilter_Seten HasIconFilter_Id
Dynamische filters gebruiken HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxValen HasDynamicFilter_MaxValSet; RawXml bewaart niet-ondersteunde filterlading
Gradiëntvullingen
TXLSXFill.AddGradientStop voegt een kleurstop toe. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCounten GradientStops stellen lineaire of padgeometrie bloot
BackgroundColorTheme, BackgroundColorIndexen BackgroundTintAndShade bewaren niet-RGB-achtergrondkleuren, en TXLSXFills.AddLinearGradient maakt een volledig lineair verloop en registreert het
TXLSXFill.ForegroundColorTheme, ForegroundColorIndexen ForegroundTintAndShade zijn de tegenhangers in de voorgrondkleur en bewaren thema-, paletindex- en tint-and-shade-voorgrondkleuren naast de RGB-waarde
Grafieken
TXLSXChart stelt PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnlyen DataLabelsRange beschikbaar
TXLSXChartPlotGroup.Assign kopieert een plotgroep; ZOrder, BarGrouping, GapWidthen Overlap regelen de volgorde en de staafgeometrie ervan
TXLSXChartSeries stelt SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPosen LabelPosSet
Per serie halen cellaboren hun tekst uit celbereiken via DataLabelsRange, DataLabelsCache, ShowDataLabelsRangeen ShowDataLabelsRangeSet; SetPointShowDataLabelsRange en TryGetPointShowDataLabelsRange beheren sparse, op 0 gebaseerde overrides voor zichtbaarheid, terwijl ResolveDataLabelsRange de toegankelijke werkbladtekst één keer per werkmapgeneratie ververs en externe caches vasthoudt zonder een gegevensbron te openen
TXLSXChartSeries.CategoriesMultiLevel schrijft c:multiLvlStrRef -categorieën voor hiërarchische aslabels, terwijl de standaard de vlakke c:strRef / c:numRef -uitvoer houdt
TXLSXChartTrendline stelt de prognoseperioden Intercept, InterceptSet, Forwarden Backward bloot, terwijl TXLSXChartAxis.ShowDispUnitsLabel het weergave-eenheidslabel stuurt
Voorwaardelijke opmaak en validaties
TXLSXConditionalFormat.ContainsCellFast voert geïndexeerde lidmaatschapscontroles uit, HasStyle rapporteert een differentiële stijl, en StdDev, EqualAverageen IsPivot stellen geavanceerde regelvlaggen bloot
TXLSXConditionalFormat.AcquireWriteGuard geeft de IXLSWorkbookWriteGuard van de werkmap terug, zodat gebatchte regelbewerkingen de werkmapgeneratie bij afronding één keer laten vorderen
TXLSXDataValidation.ContainsCellFast voert de equivalente geïndexeerde validatiebereiklidmaatschapscontrole uit
Tabellen, werkbladen, koppelingen, opmerkingen en tekeningen
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIdsen HasHeaderRow bewaren met query's ondersteunde en koploze tabelmetagegevens
TXLSXTable.FindFirst en FindNext doorzoeken een door de aanroeper aangeleverd werkblad naar rijen waarvan de genoemde kolom gelijk is aan een waarde, en geven een op 1 gebaseerde rij of 0 terug, met case-insensitive vergelijkingen voor strings, getallen en booleans
TXLSXSheets.AddCopy dupliceert een werkblad met afhankelijke objecten en ByPos opent de verzameling via de huidige tabbladpositie
TXLSXExternalLink.AddDefinedName en DefinedNameCount beheren gecachte externe namen en FindDefinedName lokaliseert één entry op naam; de read-only-properties RelationshipId, SourceSloten LinkKind tonen de relatie-id van het external-link-part, de op 1 gebaseerde [N] -slot die externe formules gebruiken en de classificatie van de koppeling (workbook, DDE, OLE of unknown); TXLSXHyperlink.TargetFrame bewaart de browsing-context van het doel
TXLSXDefinedName.UnknownAttributes bewaart onherkende attributen bij een gedefinieerde naam, zodat niet-ondersteunde extensies round-trips overleven
TXLSXComment.AutoSizeFromText past de vorm van de opmerking aan de tekst aan en ClearFont verwijdert expliciete rich-text-lettertyperuns
TXLSXImage.SvgData slaat de SVG-begeleider op en CameraRange identificeert een bronbereik van een gekoppelde afbeelding; TXLSXTextBox.PrstToken bewaart het DrawingML-voorkeuzegeometrietoken
Afbeeldingen delen payloads zonder bytes te kopiëren: het toewijzen van TXLSXImage.Blob (de interface IXLSXImageBlob met Data, SvgData, CacheKey, ContentDigest, SvgContentDigesten ByteSize) is het zero-copy-pad voor herhaalde rapportafbeeldingen, de digests worden één keer berekend voor media-interning bij het opslaan, en de read-only-eigenschappen TXLSXImage.CacheKey en ContentDigest rapporteren de toegekende identiteit; de rapportcache weigert één cache-key die opnieuw met andere bytes of indelingen wordt gebruikt
DrawingObjectCount en DrawingObject tonen één stabiele gemengde volgorde over afbeeldingen, grafieken, tekstvakken, bewaarde raw-ankers en groepen heen; elke TXLSXDrawingObject stelt Kind, Parent, ChildCounten TextBoxbloot en kan worden geherordend met BringToFront, SendToBack, BringForwarden SendBackward
GroupDrawingObjects maakt een transformatiebewuste DrawingML-groep van geselecteerde objecten en UngroupDrawingObject zet de kinderen in volgorde terug, ook voor groepen die uit een bestaand package zijn geladen
Klassieke werkbladequivalenten
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImageen BackgroundImageResource maken BIFF8-werkbladachtergronden, verwijderen die en inspecteren ze; bitmapgegevens worden als standaard BMP blootgesteld, native of onbekende indelingen behouden hun raw-payload en indelingscode, en bekende achtergronden converteren in beide richtingen tussen de klassieke en de XLSX-engine
TXLSWorksheet.ConvertFormulasToValues vervangt formules door gecachte resultaten, de OpenRTF -overloads importeren een RTF-tabel op het standaard- of door de aanroeper geselecteerde doel, WriteAutoValue selecteert een celtype uit een variant, en DefaultFormat stelt de standaard-XF van het werkblad bloot