Erweiterte XLSX-API-Member
Diese Member decken weniger gebräuchliche, aber öffentliche XLSX-Bearbeitungsflächen ab, die die primären Referenzseiten für Arbeitsmappe, Arbeitsblatt, Bereich, Style, Filter und Diagramm ergänzen
Arbeitsblattfenster, Anzeige und Hintergrund
TXLSXWorksheet.SplitPanes und RemoveSplit bearbeiten den Split-Pane-Zustand; SplitRow, SplitCol, PaneStateKind und ScrollCol legen die gespeicherten Ansichtskoordinaten offen
DisplayRowColHeaders steuert Zeilen- und Spaltenüberschriften, GridLinesSet unterscheidet eine explizite Gitterlinien-Entscheidung vom Standard, und DefaultFormat plus StyleOverlays legen den Style-Zustand auf Blattebene offen
BackgroundImageData und BackgroundImageFormat legen das Hintergrundbild des Arbeitsblatts offen, BackgroundImageResource liefert eine backend-neutrale schreibgeschützte Payload mit Formatbeschreibung, und ClearBackgroundImage entfernt es
Fensterauswahl und Bildlauf
GetSelectedAreas und die pane-first-Überladung von SelectAreas verwenden den gemeinsamen Typ TXLSPanePosition, erhalten geordnete und überlappende A1-Bereiche und liefern Snapshots in Besitz des Aufrufers inklusive Index des aktiven Bereichs
Struktur-Änderungen ganzer Zeilen und Spalten bilden jede Fensterauswahl ab, erhalten überlebende Ordnung und die Identität des aktiven Bereichs und nutzen deterministische Nachfolger-, Vorgänger- oder Grenzzellen-Fallbacks, wenn der aktive Bereich entfernt wird
Auswahl-Normalisierung, strukturelle Umordnung und Snapshot-Erzeugung nutzen Ein-Durchlauf-Builder und geometrisches Kapazitätswachstum für amortisiert lineare Verarbeitung großer Bereiche
TryGetWindowScroll und ScrollWindow verwenden dieselben logischen Fenster und 1-basierten Koordinaten und behalten dabei die Gesamt-sheetView- sowie die untere bzw. rechte pane-Bildlaufposition unabhängig voneinander bei
Fehlende Fenster und ungültige Updates lassen das Arbeitsblatt unverändert; siehe Arbeitsblatt-Fensterauswahl und Bildlauf
Paginierungsbereiche, die zusammenbleiben
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether und KeepTogetherCount definieren Blöcke, die, wo immer die Geometrie es erlaubt, auf einer Seite bleiben sollen
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow und KeepColBlockBreakCol prüfen, wie vorgeschlagene Seitenumbrüche mit diesen Blöcken interagieren
Hilfsfunktionen für die Arbeitsblattbearbeitung
AddImagePair schreibt ein primäres Bild plus ein Fallback-Begleitbild wie SVG und PNG, AddChartFromRanges erstellt ein Diagramm aus typisierten Kategorie- und Wertebereichen, und CheckDataValidations liefert jede verletzende Zelle
CheckDataValidation testet einen Kandidatenwert gegen jede Überprüfungsregel, die eine Zelle abdeckt, liefert -1 bei Gültigkeit oder den 1-basierten Index der ersten verletzenden Regel und schreibt optional nur einen gültigen Kandidaten
GetCellVisibleFormat löst die effektive Formatierung aus Arbeitsblatt, Zeile, Spalte, Bereichs-Overlay und expliziter Zelle auf, ohne eine Leerzelle zu erzeugen; Subtotal gruppiert einen sortierten Bereich nach Wechseln einer Spalte und fügt Zwischensummenformeln, optionale Gesamtergebnisformeln, geerbte Formatierung und Gliederungsebenen ein
SortRangeInternal ist der erweiterte Einstiegspunkt für stabiles Sortieren, den Bereichs- und Berichtsoperationen verwenden; Aufrufer sollten normalerweise SortRange oder TXLSXRange.Sort bevorzugen
ClearColWidth und ClearRowHeight entfernen die explizite Dimension einer Spalte oder Zeile, sodass sie auf den Blattdefault zurückfällt — Ergänzung zu den Probes HasColWidth / HasRowHeight
Gliederungsknoten-Steuerung
TryGetOutlineNode liefert den richtungsbewussten Summenknoten, den Detailbereich, die Gliederungsebene, den ausgeblendeten Zustand und den expliziten Einklapp-Marker für einen 1-basierten Zeilen- oder Spaltenindex
SetOutlineNodeCollapsed klappt einen Summenknoten idempotent ein oder aus, während SetOutlineDisplayLevel die 1-basierte Gliederungsbutton-Ebene über jede materialisierte Gruppe anwendet; beide akzeptieren xocPreserve, xocCollapse oder xocExpand für die Behandlung der Kinder
ToggleRowGrouped und ToggleColGrouped bleiben Kompatibilitäts-Wrapper, die den ersten Detailindex entgegennehmen und den tatsächlichen Summenknoten über SummaryBelow oder SummaryRight auflösen
Native OpenDocument-Zeilen- und Spaltengruppen mappen über table:display, überstehen direkte Metadaten- und Struktur-Änderungen und konvertieren zu XLSX-Summenknoten-Markern, ohne Collapse-Flags auf Member-Ebene zu behalten; siehe Dünn besetzte Gliederungsgeometrie
Benannte Styles und Tabellenstyle-Auflösung
TXLSXRange.ApplyNamedStyle verknüpft einen Bereich mit einem benannten Zellstyle; TXLSXLinkedStyle.AutomaticChoose leitet die betroffenen Formatteile aus dem Style ab, während LinkedParts Schrift, Füllung, Rahmen, Zahlenformat, Ausrichtung oder Schutz explizit wählt
Bearbeitet man TXLSXNamedStyle.Style, werden verknüpfte Teile aktualisiert, ohne lokale Overrides zu verwerfen, und GetCellVisibleFormat löst das Ergebnis zusammen mit Arbeitsblatt-Overlays und Tabellenstyles auf, ohne Leerzellen zu materialisieren
TXLSXNamedStyles.FindByName findet einen benannten Style-Eintrag über seinen Anzeigenamen, ohne die Sammlung manuell zu durchsuchen
Alle 60 eingebauten hellen, mittleren und dunklen Tabellenstyle-Namen auflösen zu vollständigen themenbasierten Abschnittsformaten, die von HTML-, PDF-, Bild-, Vorschau- und Viewer-Ausgabe gemeinsam genutzt werden
Formelkonvertierung
TXLSXCell.ConvertFormulaToValue ersetzt eine Formel durch ihren zwischengespeicherten Wert, und TXLSXCells.ConvertFormulasToValues wendet dieselbe Operation auf die gespeicherte Zellensammlung an
Formeleingabe-Validierung
TXLSXWorkbook.FormulaEntryPolicy und TXLSXWorksheet.ValidateFormulaEntry legen den gemeinsamen mutationsfreien Formeleingabe-Vertrag offen, unterscheiden leeren Text, unbekannte Funktionen, unbekannte Namen, Syntaxfehler und ungültige Ziele und erkennen registrierte Benutzerfunktionen, ohne sie aufzurufen; siehe Richtlinie zur Formeleingabe-Validierung
Zellspeicher-Diagnose
TXLSXCells.PackedStorageEnabled steuert das gepackte RLE-Backend, das kompatible zeilenorientierte typisierte Bulk-Writes verwenden, und PackedCellCount meldet die dort gehaltenen Zellen, bevor der Zugriff auf Objektebene stabile Zell-Handles materialisiert
GetStorageStatistics meldet Zeilenblöcke, befüllte Zeilen sowie Objekt-, Text-, Formel-, Rich-Text-, geschätzte gepackte, aktive gepackte, allokalierte, benutzte und gepackte String-Byte-Zahlen für messbare Speicherentscheidungen; Style-Payload-Zähler und vermiedene Styled-Blank-Payload-Bytes legen das Copy-on-Write-Sharing direkt offen
AutoFilter-Details
TXLSXAutoFilterColumn.ClearValueFilters löscht Wert- und Datumsgruppenfilter und behält den Spalteneintrag
HasCriteria2 und AndConnector beschreiben benutzerdefinierte Filter mit zwei Bedingungen; Farbfilter verwenden HasColorFilter, HasColorFilter_CellColor und HasColorFilter_DxfId; Symbolfilter verwenden HasIconFilter, HasIconFilter_Set und HasIconFilter_Id
Dynamische Filter verwenden HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal und HasDynamicFilter_MaxValSet; RawXml bewahrt nicht unterstützte Filter-Payloads
Verlaufsfüllungen
TXLSXFill.AddGradientStop hängt einen Farbstopp an. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount und GradientStops legen lineare oder Pfad-Geometrie offen
BackgroundColorTheme, BackgroundColorIndex und BackgroundTintAndShade erhalten Nicht-RGB-Hintergrundfarben, und TXLSXFills.AddLinearGradient erstellt und registriert einen vollständigen linearen Verlauf
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex und ForegroundTintAndShade sind die Vordergrund-Pendants und erhalten Theme-, Palettenindex- und TintAndShade-Vordergrundfarben neben dem RGB-Wert
Diagramme
TXLSXChart legt PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly und die Kompatibilitäts-Fassade DataLabelsRange offen; deren Setter überträgt an aktuelle Datenreihen und sät spätere Reihen vorab, während der Getter nur eine gemeinsame Formel pro Reihe zurückgibt
TXLSXChartPlotGroup.Assign kopiert eine Plotgruppe; ZOrder, BarGrouping, GapWidth und Overlap steuern ihre Ordnung und Balkengeometrie
TXLSXChartSeries legt SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos und LabelPosSet offen
Zellbasierte Labels pro Datenreihe verwenden DataLabelsRange, DataLabelsCache, ShowDataLabelsRange und ShowDataLabelsRangeSet; SetPointShowDataLabelsRange und TryGetPointShowDataLabelsRange pflegen sparse nullbasierte Sichtbarkeits-Overrides, während ResolveDataLabelsRange den zugreifbaren Arbeitsblatttext einmal je Arbeitsmappengeneration aktualisiert und externe Caches hält, ohne eine Datenquelle zu öffnen
TXLSXChartSeries.CategoriesMultiLevel emittiert c:multiLvlStrRef-Kategorien für hierarchische Achsenbeschriftungen, während der Default die flache c:strRef / c:numRef-Emission beibehält
TXLSXChartTrendline legt Intercept, InterceptSet, Forward und Backward für Prognoseperioden offen, während TXLSXChartAxis.ShowDispUnitsLabel das Anzeigeeinheiten-Label steuert
Bedingte Formate und Validierungen
TXLSXConditionalFormat.ContainsCellFast führt indizierte Mitgliedschaftsprüfungen aus, HasStyle meldet einen differential Style, und StdDev, EqualAverage und IsPivot legen erweiterte Regel-Flags offen
TXLSXConditionalFormat.AcquireWriteGuard liefert den IXLSWorkbookWriteGuard der Arbeitsmappe, sodass stapelweise Regel-Änderungen die Arbeitsmappengeneration bei Abschluss genau einmal weiterstellen
TXLSXDataValidation.ContainsCellFast führt die entsprechende indizierte Mitgliedschaftsprüfung des Validierungsbereichs aus
Tabellen, Blätter, Links, Kommentare und Zeichnungen
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds und HasHeaderRow bewahren Metadaten von abfragegestützten und kopflosen Tabellen
TXLSXTable.FindFirst und FindNext durchsuchen ein vom Aufrufer geliefertes Arbeitsblatt nach Zeilen, deren benannte Spalte einem Wert entspricht, und liefern eine 1-basierte Zeile oder 0 — mit Groß-/Kleinschreibungs-unabhängigem Stringvergleich sowie numerischen und booleschen Vergleichen
TXLSXSheets.AddCopy dupliziert ein Arbeitsblatt mit abhängigen Objekten, und ByPos greift über die aktuelle Registerposition auf die Sammlung zu
TXLSXExternalLink.AddDefinedName und DefinedNameCount pflegen zwischengespeicherte externe Namen, und FindDefinedName findet einen Eintrag über den Namen; die schreibgeschützten Eigenschaften RelationshipId, SourceSlot und LinkKind legen die Beziehungs-ID des External-Link-Teils, den 1-basierten [N]-Slot, den externe Formeln verwenden, und die Link-Klassifikation (Arbeitsmappe, DDE, OLE oder unbekannt) offen; TXLSXHyperlink.TargetFrame bewahrt den Ziel-Browsing-Kontext
TXLSXDefinedName.UnknownAttributes bewahrt nicht erkannte Attribute eines definierten Namens, damit nicht unterstützte Erweiterungen Roundtrips überstehen
TXLSXComment.AutoSizeFromText passt die Kommentarform an ihren Text an, und ClearFont entfernt explizite Rich-Text-Schriftläufe
TXLSXImage.SvgData speichert das SVG-Begleitbild, und CameraRange identifiziert den Quellbereich eines verknüpften Bilds; TXLSXTextBox.PrstToken bewahrt das DrawingML-Preset-Geometrie-Token
Bilder teilen Payloads, ohne Bytes zu kopieren: Die Zuweisung von TXLSXImage.Blob (das IXLSXImageBlob-Interface mit Data, SvgData, CacheKey, ContentDigest, SvgContentDigest und ByteSize) ist der Zero-Copy-Pfad für wiederkehrende Berichtsbilder, die Digests werden einmal für das Media-Interning beim Speichern berechnet, und die schreibgeschützten TXLSXImage.CacheKey und ContentDigest melden die zugewiesene Identität; der Berichts-Cache lehnt einen Cache-Key ab, der mit anderen Bytes oder Formaten wiederverwendet wird
DrawingObjectCount und DrawingObject legen eine stabile gemischte Reihenfolge über Bilder, Diagramme, Textfelder, erhaltene rohe Anker und Gruppen offen; jedes TXLSXDrawingObject legt Kind, Parent, ChildCount und TextBox offen und lässt sich mit BringToFront, SendToBack, BringForward und SendBackward umordnen
GroupDrawingObjects erzeugt eine transform-bewusste DrawingML-Gruppe aus ausgewählten Objekten, und UngroupDrawingObject stellt ihre Kinder in Ordnung wieder her — einschließlich Gruppen aus einem bestehenden Paket
Klassische Arbeitsblatt-Gegenstücke
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage und BackgroundImageResource erzeugen, entfernen und lesen BIFF8-Arbeitsblatthintergründe; Bitmap-Daten werden als Standard-BMP offengelegt, native oder unbekannte Formate behalten ihre rohe Payload und ihren Formatcode, und bekannte Hintergründe konvertieren in beide Richtungen zwischen der Classic- und der XLSX-Engine
TXLSWorksheet.ConvertFormulasToValues ersetzt Formeln durch zwischengespeicherte Ergebnisse, die OpenRTF-Überladungen importieren eine RTF-Tabelle am Standard- oder vom Aufrufer gewählten Ziel, WriteAutoValue wählt einen Zelltyp aus einem Variant, und DefaultFormat legt den Standard-XF des Arbeitsblatts offen