Membri avanzati dell'API XLSX
Questi membri coprono superfici di modifica XLSX meno comuni ma pubbliche che completano le pagine di riferimento principali su cartella di lavoro, foglio di lavoro, intervallo, stile, filtro e grafico
Riquadri, visualizzazione e sfondo del foglio di lavoro
TXLSXWorksheet.SplitPanes e RemoveSplit modificano lo stato dei riquadri divisi; SplitRow, SplitCol, PaneStateKinde ScrollCol espongono le coordinate di vista memorizzate
DisplayRowColHeaders controlla le intestazioni di riga e colonna, GridLinesSet distingue una scelta esplicita delle linee della griglia dal valore predefinito e DefaultFormat più StyleOverlays espongono lo stato degli stili a livello di foglio
BackgroundImageData e BackgroundImageFormat espongono l'immagine di sfondo del foglio di lavoro, mentre BackgroundImageResource la rimuove ClearBackgroundImage removes it
Selezioni dei riquadri e scorrimento
GetSelectedAreas e l'overload di SelectAreas con priorità ai riquadri usano il tipo condiviso TXLSPanePosition , preservano le aree A1 ordinate e sovrapposte e restituiscono istantanee di proprietà del chiamante con l'indice dell'area attiva
Le modifiche strutturali a intere righe e colonne rimappano ogni selezione dei riquadri, preservano l'ordine superstite e l'identità dell'area attiva e usano fallback deterministici sul successore, sul predecessore o sulla cella di confine quando l'area attiva viene rimossa
Normalizzazione delle selezioni, rimappatura strutturale e costruzione delle istantanee usano builder a un passaggio e crescita geometrica della capacità, per elaborare grandi insiemi di aree con costo ammortizzato quasi lineare
TryGetWindowScroll e ScrollWindow usano gli stessi riquadri logici e le coordinate a base uno, conservando in modo indipendente lo scorrimento complessivo di sheetView e quello del riquadro inferiore o destro pane scroll positions independently
Riquadri mancanti e aggiornamenti non validi lasciano il foglio di lavoro invariato; vedere Selezioni dei riquadri del foglio di lavoro e scorrimento
Intervalli di impaginazione da mantenere insieme
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogethere KeepTogetherCount definiscono blocchi che devono rimanere su una pagina dove la geometria lo consente
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRowe KeepColBlockBreakCol ispezionano come le interruzioni di pagina proposte interagiscono con questi blocchi
Helper di modifica del foglio di lavoro
AddImagePair scrive un'immagine primaria più un compagno di fallback come SVG e PNG, AddChartFromRanges crea un grafico da intervalli tipizzati di categorie e valori e CheckDataValidations restituisce ogni cella che viola le convalide
CheckDataValidation verifica un valore candidato rispetto a ogni regola di convalida che copre una cella, restituisce -1 quando è valido oppure l'indice (base uno) della prima regola non soddisfatta, e facoltativamente conferma solo un candidato valido
GetCellVisibleFormat risolve la formattazione effettiva di foglio di lavoro, riga, colonna, overlay di intervallo e cella esplicita senza creare una cella vuota; Subtotal raggruppa un intervallo ordinato in base alle variazioni di una colonna e inserisce formule di subtotale, formule opzionali di totale generale, formattazione ereditata e livelli di struttura
SortRangeInternal è il punto di ingresso avanzato dell'ordinamento stabile usato dalle operazioni su intervalli e report; i chiamanti dovrebbero normalmente preferire SortRange o TXLSXRange.Sort
ClearColWidth e ClearRowHeight rimuovono la dimensione esplicita di una colonna o di una riga, che ricade sul predefinito del foglio, completando le verifiche HasColWidth / HasRowHeight probes
Controllo dei nodi della struttura
TryGetOutlineNode restituisce il nodo di riepilogo consapevole della direzione, l'intervallo di dettaglio, il livello della struttura, lo stato nascosto e il marcatore di collasso esplicito per un indice di riga o colonna a base uno
SetOutlineNodeCollapsed collassa o espande in modo idempotente un nodo di riepilogo, mentre SetOutlineDisplayLevel applica il livello del pulsante della struttura (base uno) a ogni gruppo materializzato; entrambi accettano la gestione dei figli xocPreserve, xocCollapseo xocExpand child handling
ToggleRowGrouped e ToggleColGrouped restano wrapper di compatibilità che accettano il primo indice di dettaglio e risolvono il nodo di riepilogo effettivo da SummaryBelow o SummaryRight
I gruppi nativi di righe e colonne OpenDocument vengono mappati tramite table:display, sopravvivono alle modifiche dirette di metadati e struttura e vengono convertiti in marcatori di nodi di riepilogo XLSX senza conservare i flag di collasso a livello di membro; vedere Sparse outline geometry
Stili denominati e risoluzione degli stili tabella
TXLSXRange.ApplyNamedStyle collega un intervallo a uno stile di cella denominato; TXLSXLinkedStyle.AutomaticChoose deriva dallo stile le parti di formato interessate, mentre LinkedParts seleziona esplicitamente font, riempimento, bordo, formato numerico, allineamento o protezione
Modificare TXLSXNamedStyle.Style aggiorna le parti collegate senza scartare le override locali, e GetCellVisibleFormat risolve il risultato insieme agli overlay del foglio di lavoro e agli stili tabella senza materializzare celle vuote
TXLSXNamedStyles.FindByName individua una voce di stile denominato per il suo nome visualizzato senza scansionare manualmente la raccolta
Tutti i 60 nomi di stili tabella light, medium e dark incorporati si risolvono in formati di sezione completi basati sul tema, condivisi dall'output HTML, PDF, immagine, anteprima e viewer
Conversione delle formule
TXLSXCell.ConvertFormulaToValue sostituisce una formula con il suo valore memorizzato nella cache e TXLSXCells.ConvertFormulasToValues applica la stessa operazione alla raccolta di celle memorizzata
Convalida dell'inserimento delle formule
TXLSXWorkbook.FormulaEntryPolicy e TXLSXWorksheet.ValidateFormulaEntry espongono il contratto condiviso di convalida dell'inserimento delle formule senza mutazioni, distinguono testo vuoto, funzioni sconosciute, nomi sconosciuti, errori di sintassi e destinazioni non valide e riconoscono le funzioni utente registrate senza invocarle; vedere Formula entry validation policy
Diagnostica dello storage delle celle
TXLSXCells.PackedStorageEnabled controlla il backend compresso RLE usato dalle scritture bulk tipizzate compatibili in ordine riga-principale, e PackedCellCount riporta le celle ivi trattenute prima che l'accesso a livello di oggetto materializzi handle di cella stabili
GetStorageStatistics riporta blocchi di riga, righe popolate e conteggi di byte di oggetti, testo, formule, testo ricco, stime compresse, compressed attive, allocato, usato e stringhe compresse, per decisioni di memoria misurabili; i conteggi dei payload di stile e i byte di payload di celle vuote con stile risparmiati espongono direttamente la condivisione copy-on-write
Dettagli del filtro automatico
TXLSXAutoFilterColumn.ClearValueFilters cancella i filtri sui valori e sui gruppi di date conservando la voce di colonna
HasCriteria2 e AndConnector descrivono filtri personalizzati a due condizioni; i filtri colore usano HasColorFilter, HasColorFilter_CellColore HasColorFilter_DxfId; i filtri icona usano HasIconFilter, HasIconFilter_Sete HasIconFilter_Id
I filtri dinamici usano HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVale HasDynamicFilter_MaxValSet; RawXml preserva il payload di filtro non supportato
Riempimenti sfumati
TXLSXFill.AddGradientStop aggiunge un arresto di colore. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCounte GradientStops espongono la geometria lineare o di percorso
BackgroundColorTheme, BackgroundColorIndexe BackgroundTintAndShade preservano i colori di sfondo non RGB e TXLSXFills.AddLinearGradient crea e registra un gradiente lineare completo
TXLSXFill.ForegroundColorTheme, ForegroundColorIndexe ForegroundTintAndShade sono le controparti di primo piano, e preservano i colori di primo piano tema, indice-palette e tinta accanto al valore RGB
Grafici
TXLSXChart espone PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnlye la facciata di compatibilità DataLabelsRange , il cui setter trasmette alle serie correnti e innesca le serie successive mentre il getter restituisce solo una formula comune per serie
TXLSXChartPlotGroup.Assign copia un gruppo di grafico; ZOrder, BarGrouping, GapWidthe Overlap controllano il suo ordinamento e la geometria delle barre
TXLSXChartSeries espone SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPose LabelPosSet
Le etichette dati per serie provenienti dalle celle usano DataLabelsRange, DataLabelsCache, ShowDataLabelsRangee ShowDataLabelsRangeSet; SetPointShowDataLabelsRange e TryGetPointShowDataLabelsRange gestiscono override di visibilità sparsi a base zero, mentre ResolveDataLabelsRange aggiorna una sola volta per generazione della cartella di lavoro il testo accessibile del foglio di lavoro e conserva le cache esterne senza aprire una sorgente dati
TXLSXChartSeries.CategoriesMultiLevel emette categorie c:multiLvlStrRef per le etichette gerarchiche degli assi, mentre il default mantiene l'emissione piatta c:strRef / c:numRef emission
TXLSXChartTrendline espone Intercept, InterceptSete i periodi di previsione Forwarde Backward , mentre TXLSXChartAxis.ShowDispUnitsLabel controlla l'etichetta delle unità di visualizzazione
Formati condizionali e convalide
TXLSXConditionalFormat.ContainsCellFast esegue controlli di appartenenza indicizzati, HasStyle segnala uno stile differenziale e StdDev, EqualAveragee IsPivot espongono flag di regola avanzati
TXLSXConditionalFormat.AcquireWriteGuard restituisce l' IXLSWorkbookWriteGuard della cartella di lavoro, così le modifiche a lotti di regole fanno avanzare la generazione della cartella di lavoro una sola volta al completamento
TXLSXDataValidation.ContainsCellFast esegue il controllo equivalente indicizzato di appartenenza all'intervallo di convalida
Tabelle, fogli, collegamenti, commenti e disegni
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIdse HasHeaderRow preservano i metadati di tabelle basate su query e senza intestazione
TXLSXTable.FindFirst e FindNext scansionano un foglio di lavoro fornito dal chiamante alla ricerca delle righe la cui colonna denominata è uguale a un valore, restituendo una riga a base uno oppure 0, con confronti di stringhe, numeri e booleani senza distinzione maiuscole/minuscole
TXLSXSheets.AddCopy duplica un foglio di lavoro con gli oggetti dipendenti e ByPos accede alla raccolta in base alla posizione corrente della scheda
TXLSXExternalLink.AddDefinedName e DefinedNameCount mantengono i nomi esterni in cache e FindDefinedName individua una voce per nome; le proprietà di sola lettura RelationshipId, SourceSlote LinkKind espongono l'id di relazione della parte di collegamento esterno, lo slot [N] a base uno usato dalle formule esterne e la classificazione del collegamento (cartella di lavoro, DDE, OLE o sconosciuto); TXLSXHyperlink.TargetFrame preserva il contesto di navigazione di destinazione
TXLSXDefinedName.UnknownAttributes preserva gli attributi non riconosciuti su un nome definito, così le estensioni non supportate sopravvivono ai round trip
TXLSXComment.AutoSizeFromText dimensiona la forma del commento in base al suo testo e ClearFont rimuove i run di font rich text espliciti
TXLSXImage.SvgData memorizza il compagno SVG e CameraRange identifica un intervallo sorgente di immagine collegata; TXLSXTextBox.PrstToken preserva il token di geometria predefinita DrawingML
Le immagini condividono i payload senza copiare byte: assegnare TXLSXImage.Blob (l'interfaccia IXLSXImageBlob con Data, SvgData, CacheKey, ContentDigest, SvgContentDigeste ByteSize) è il percorso a copia zero per le immagini di report ripetute, i digest vengono calcolati una sola volta per l'interning dei media al salvataggio, e i TXLSXImage.CacheKey e ContentDigest di sola lettura riportano l'identità assegnata; la cache dei report rifiuta una cache key riusata con byte o formati diversi
DrawingObjectCount e DrawingObject espongono un unico ordine misto stabile tra immagini, grafici, caselle di testo, ancoraggi raw preservati e gruppi; ogni TXLSXDrawingObject espone Kind, Parent, ChildCounte TextBox, e può essere riordinato con BringToFront, SendToBack, BringForwarde SendBackward
GroupDrawingObjects crea un gruppo DrawingML consapevole delle trasformazioni a partire dagli oggetti selezionati e UngroupDrawingObject ripristina i figli in ordine, compresi i gruppi caricati da un pacchetto esistente
Controparti classiche del foglio di lavoro
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImagee BackgroundImageResource creano, rimuovono e ispezionano gli sfondi del foglio di lavoro BIFF8; i dati bitmap sono esposti come BMP standard, i formati nativi o sconosciuti conservano il payload raw e il codice di formato, e gli sfondi noti si convertono in entrambe le direzioni tra il motore Classic e quello XLSX
TXLSWorksheet.ConvertFormulasToValues sostituisce le formule con risultati memorizzati nella cache, gli overload di OpenRTF importano una tabella RTF nella destinazione predefinita o selezionata dal chiamante, WriteAutoValue seleziona un tipo di cella da una variante e DefaultFormat espone l'XF predefinito del foglio di lavoro