Membres avancés de l'API XLSX
Ces membres couvrent des surfaces d'édition XLSX moins courantes mais publiques, qui complètent les pages de référence principales du classeur, de la feuille de calcul, de la plage, du style, du filtre et du graphique
Volets, affichage et arrière-plan de feuille de calcul
TXLSXWorksheet.SplitPanes et RemoveSplit modifient l'état des volets divisés ; SplitRow, SplitCol, PaneStateKindet ScrollCol exposent les coordonnées de vue stockées
DisplayRowColHeaders contrôle les en-têtes de lignes et de colonnes, GridLinesSet distingue un choix explicite de quadrillages du défaut, et DefaultFormat ainsi que StyleOverlays exposent l'état de style au niveau de la feuille
BackgroundImageData et BackgroundImageFormat exposent l'image d'arrière-plan de la feuille de calcul, BackgroundImageResource fournit une charge utile en lecture seule indépendante du backend avec sa description de format, et ClearBackgroundImage la supprime
Sélections de volets et défilement
GetSelectedAreas et la surcharge SelectAreas prioritaire aux volets utilisent le type partagé TXLSPanePosition , préservent des zones A1 ordonnées et chevauchantes, et renvoient des instantanés appartenant à l'appelant avec l'index de la zone active
Les éditions structurelles de lignes et de colonnes entières remappent chaque sélection de volet, préservent l'ordre survivant et l'identité de la zone active, et utilisent des replis déterministes vers la cellule successeur, prédécesseur ou de bordure quand la zone active est supprimée
La normalisation des sélections, le remappage structurel et la construction d'instantanés utilisent des builders en une seule passe et une croissance géométrique de capacité pour un traitement des grandes zones en temps linéaire amorti
TryGetWindowScroll et ScrollWindow utilisent les mêmes volets logiques et coordonnées en base un tout en conservant indépendamment le sheetView global et les positions de défilement du pane inférieur ou droit
Des volets manquants et des mises à jour invalides laissent la feuille de calcul inchangée ; voir Worksheet pane selections and scrolling
Plages à maintenir ensemble en pagination
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogetheret KeepTogetherCount définissent des blocs qui doivent rester sur une même page lorsque la géométrie le permet
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRowet KeepColBlockBreakCol inspectent l'interaction des sauts de page proposés avec ces blocs
Fonctions d'aide d'édition de feuille de calcul
AddImagePair écrit une image principale plus un compagnon de repli tel que SVG et PNG, AddChartFromRanges construit un graphique à partir de plages typées de catégories et de valeurs, et CheckDataValidations renvoie chaque cellule en violation
CheckDataValidation teste une valeur candidate contre chaque règle de validation couvrant une cellule, renvoie -1 quand elle est valide ou l'index en base un de la première règle en échec, et optionnellement ne valide que la candidate correcte
GetCellVisibleFormat résout la mise en forme effective de feuille, ligne, colonne, superposition de plage et cellule explicite sans créer de cellule vide ; Subtotal groupe une plage triée par changements d'une colonne et insère les formules de sous-total, les formules de total général optionnelles, la mise en forme héritée et les niveaux de plan
SortRangeInternal est le point d'entrée avancé de tri stable utilisé par les opérations de plage et de rapport ; les appelants devraient normalement préférer SortRange ou TXLSXRange.Sort
ClearColWidth et ClearRowHeight suppriment la dimension explicite d'une colonne ou d'une ligne pour qu'elle retombe sur la valeur par défaut de la feuille, en complément des sondes HasColWidth / HasRowHeight probes
Contrôle des nœuds de plan
TryGetOutlineNode renvoie le nœud de synthèse sensible à la direction, la plage de détail, le niveau de plan, l'état masqué et le marqueur de repli explicite pour un index de ligne ou de colonne en base un
SetOutlineNodeCollapsed replie ou déplie de façon idempotente un nœud de synthèse, tandis que SetOutlineDisplayLevel applique le niveau de bouton de plan en base un à chaque groupe matérialisé ; tous deux acceptent la gestion des enfants xocPreserve, xocCollapseou xocExpand child handling
ToggleRowGrouped et ToggleColGrouped restent des surcouches de compatibilité qui acceptent le premier index de détail et résolvent le nœud de synthèse réel depuis SummaryBelow ou SummaryRight
Les groupes natifs de lignes et colonnes OpenDocument se mappent via table:display, survivent aux éditions directes de métadonnées et structurelles, et se convertissent en marqueurs de nœuds de synthèse XLSX sans conserver les indicateurs de repli au niveau membre ; voir Sparse outline geometry
Styles nommés et résolution des styles de table
TXLSXRange.ApplyNamedStyle lie une plage à un style de cellule nommé ; TXLSXLinkedStyle.AutomaticChoose déduit les parties de format concernées à partir du style, tandis que LinkedParts sélectionne explicitement police, remplissage, bordure, format numérique, alignement ou protection
L'édition de TXLSXNamedStyle.Style met à jour les parties liées sans rejeter les surcharges locales, et GetCellVisibleFormat résout le résultat avec les superpositions de feuille et les styles de table sans matérialiser de cellules vides
TXLSXNamedStyles.FindByName localise une entrée de style nommé par son nom d'affichage sans scanner la collection manuellement
Les 60 noms de styles de table light, medium et dark intégrés se résolvent en formats de sections complets basés sur le thème, partagés par les sorties HTML, PDF, image, aperçu et viewer
Conversion de formules
TXLSXCell.ConvertFormulaToValue remplace une formule par sa valeur mise en cache et TXLSXCells.ConvertFormulasToValues applique la même opération à la collection de cellules stockée
Formula entry validation
TXLSXWorkbook.FormulaEntryPolicy and TXLSXWorksheet.ValidateFormulaEntry exposent le contrat commun, sans mutation, d'entrée de formule, distinguent texte vide, fonctions inconnues, noms inconnus, échecs de syntaxe et cibles invalides, et reconnaissent les fonctions utilisateur enregistrées sans les invoquer ; voir Formula entry validation policy
Cell storage diagnostics
TXLSXCells.PackedStorageEnabled contrôle le backend RLE compacté utilisé par les écritures en bloc typées compatibles row-major, et PackedCellCount indique les cellules conservées à cet endroit avant que l'accès au niveau objet ne matérialise des handles de cellules stables
GetStorageStatistics applique la même opération à la collection de cellules stockée
Détails du filtre automatique
TXLSXAutoFilterColumn.ClearValueFilters efface les filtres de valeurs et de groupes de dates tout en conservant l'entrée de colonne
HasCriteria2 et AndConnector décrivent les filtres personnalisés à deux conditions ; les filtres de couleur utilisent HasColorFilter, HasColorFilter_CellColoret HasColorFilter_DxfId; les filtres d'icônes utilisent HasIconFilter, HasIconFilter_Setet HasIconFilter_Id
Les filtres dynamiques utilisent HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxValet HasDynamicFilter_MaxValSet; RawXml préserve les données de filtre non prises en charge
Remplissages en dégradé
TXLSXFill.AddGradientStop ajoute un point de couleur. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCountet GradientStops exposent la géométrie linéaire ou de trajectoire
BackgroundColorTheme, BackgroundColorIndex, and BackgroundTintAndShade preserve non-RGB background colors, and TXLSXFills.AddLinearGradient crée et enregistre un dégradé linéaire complet
TXLSXFill.ForegroundColorThemeet ForegroundColorIndexpréservent les couleurs d'arrière-plan non RGB, et ForegroundTintAndShade crée et enregistre un dégradé linéaire complet
Graphiques
TXLSXChart expose PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnlyet la façade de compatibilité DataLabelsRange , dont le setter diffuse vers les séries courantes et amorce les séries ultérieures tandis que son getter ne renvoie qu'une formule commune par série
TXLSXChartPlotGroup.Assign copie un groupe de tracés ; ZOrder, BarGrouping, GapWidthet Overlap contrôlent son ordre et sa géométrie de barres
TXLSXChartSeries expose SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPoset LabelPosSet
Les étiquettes issues de cellules par série utilisent DataLabelsRange, DataLabelsCache, ShowDataLabelsRangeet ShowDataLabelsRangeSet; SetPointShowDataLabelsRange et TryGetPointShowDataLabelsRange maintiennent des surcharges creuses de visibilité en base zéro, tandis que ResolveDataLabelsRange rafraîchit une fois par génération de classeur le texte accessible de la feuille de calcul et conserve les caches externes sans ouvrir de source de données
TXLSXChartSeries.CategoriesMultiLevel émet des catégories c:multiLvlStrRef pour des étiquettes d'axes hiérarchiques, le défaut conservant l'émission plate c:strRef / c:numRef emission
TXLSXChartTrendline expose Intercept, InterceptSet, Forwardet Backward comme périodes de prévision, tandis que TXLSXChartAxis.ShowDispUnitsLabel contrôle le libellé des unités d'affichage
Mises en forme conditionnelles et validations
TXLSXConditionalFormat.ContainsCellFast effectue des vérifications d'appartenance indexées, HasStyle signale un style différentiel, et StdDev, EqualAverageet IsPivot exposent des indicateurs de règle avancés
TXLSXConditionalFormat.AcquireWriteGuard renvoie le IXLSWorkbookWriteGuard du classeur afin que les éditions de règles par lots fassent avancer la génération du classeur une seule fois à l'achèvement
TXLSXDataValidation.ContainsCellFast effectue la vérification équivalente d'appartenance indexée à la plage de validation
Tables, feuilles, liens, commentaires et dessins
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIdset HasHeaderRow préservent les métadonnées de tables adossées à des requêtes et sans en-tête
TXLSXTable.FindFirst et FindNext scannent une feuille de calcul fournie par l'appelant pour les lignes dont la colonne nommée égale une valeur, en renvoyant une ligne en base un ou 0, avec des comparaisons de chaînes insensibles à la casse, numériques et booléennes
TXLSXSheets.AddCopy duplique une feuille de calcul avec les objets dépendants et ByPos accède à la collection par position d'onglet courante
TXLSXExternalLink.AddDefinedName et DefinedNameCount maintiennent les noms externes en cache et FindDefinedName localise une entrée par nom ; les propriétés en lecture seule RelationshipId, SourceSlotet LinkKind exposent l'identifiant de relation de la partie de lien externe, l'emplacement [N] en base un utilisé par les formules externes, et la classification du lien (workbook, DDE, OLE ou unknown) ; TXLSXHyperlink.TargetFrame préserve le contexte de navigation cible
TXLSXDefinedName.UnknownAttributes préserve les attributs non reconnus d'un nom défini afin que les extensions non prises en charge survivent aux allers-retours
TXLSXComment.AutoSizeFromText dimensionne la forme du commentaire selon son texte et ClearFont supprime les segments de police en texte enrichi explicites
TXLSXImage.SvgData stocke le compagnon SVG et CameraRange identifie la plage source d'une image liée ; TXLSXTextBox.PrstToken préserve le jeton de géométrie prédéfinie DrawingML
Les images partagent les charges utiles sans copier les octets : affecter TXLSXImage.Blob (l'interface IXLSXImageBlob avec Data, SvgData, CacheKey, ContentDigest, SvgContentDigestet ByteSize) est le chemin zéro-copie pour les images de rapport répétées, les condensés sont calculés une seule fois pour l'internement des médias à l'enregistrement, et les TXLSXImage.CacheKey et ContentDigest en lecture seule signalent l'identité affectée ; le cache de rapport refuse une clé de cache réutilisée avec des octets ou des formats différents
DrawingObjectCount et DrawingObject exposent un ordre mixte stable à travers images, graphiques, zones de texte, ancres brutes préservées et groupes ; chaque TXLSXDrawingObject expose Kind, Parent, ChildCountet TextBox, et peut être réordonné avec BringToFront, SendToBack, BringForwardet SendBackward
GroupDrawingObjects crée un groupe DrawingML conscient des transformations à partir des objets sélectionnés et UngroupDrawingObject restaure ses enfants dans l'ordre, y compris les groupes chargés depuis un package existant
Équivalents classiques de feuille de calcul
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImageet BackgroundImageResource créent, suppriment et inspectent les arrière-plans de feuilles BIFF8 ; les données bitmap sont exposées en BMP standard, les formats natifs ou inconnus conservent leur charge utile brute et leur code de format, et les arrière-plans connus se convertissent dans les deux sens entre les moteurs Classic et XLSX
TXLSWorksheet.ConvertFormulasToValues remplace les formules par des résultats mis en cache, les surcharges OpenRTF importent une table RTF à la cible par défaut ou choisie par l'appelant, WriteAutoValue sélectionne un type de cellule à partir d'un variant et DefaultFormat expose le XF par défaut de la feuille de calcul