Další členové API XLSX fasády
Tyto členy pokrývají méně běžné, ale veřejné editační plochy XLSX, které doplňují primární referenční stránky sešitu, listu, oblastí, stylů, filtru a grafů
Podokna listu, zobrazení a pozadí
TXLSXWorksheet.SplitPanes a RemoveSplit upravují stav rozdělených podoken; SplitRow, SplitCol, PaneStateKind a ScrollCol zpřístupňují uložené souřadnice zobrazení
DisplayRowColHeaders řídí záhlaví řádků a sloupců, GridLinesSet rozlišuje explicitní volbu mřížky od výchozí a DefaultFormat spolu s StyleOverlays zpřístupňují stav stylů na úrovni listu
BackgroundImageData a BackgroundImageFormat zpřístupňují obrázek na pozadí listu, BackgroundImageResource poskytuje backendově neutrální read-only payload s popisem formátu a ClearBackgroundImage jej odstraní
Výběry podoken a rolování
GetSelectedAreas a overload SelectAreas s prioritou podoken používají sdílený typ TXLSPanePosition, zachovávají uspořádané a překrývající se oblasti A1 a vrací snapshoty ve vlastnictví volajícího s indexem aktivní oblasti
Strukturní úpravy celých řádků a sloupců přemapují každý výběr podoken, zachovají přeživší pořadí i identitu aktivní oblasti a při odstranění aktivní oblasti použijí deterministického následníka, předchůdce nebo hraniční buňku
Normalizace výběru, strukturní přemapování i stavba snapshotů používají one-pass stavitelé a geometrický růst kapacity, aby zpracování velkých oblastí zůstalo amortizovaně lineární
TryGetWindowScroll a ScrollWindow používají stejná logická podokna a 1-based souřadnice, přičemž celkové sheetView a dolní či pravé pane si udržují rolovací pozice nezávisle
Chybějící podokna a neplatné aktualizace nechají list beze změn; viz Worksheet pane selections and scrolling
Rozsahy držené pohromadě při stránkování
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether a KeepTogetherCount definují bloky, které by měly zůstat na jedné stránce tam, kde to geometrie umožňuje
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow a KeepColBlockBreakCol kontrolují, jak navrhované konce stránek interagují s těmito bloky
Pomocníci pro úpravu listu
AddImagePair zapisuje primární obrázek plus doprovodnou náhradu, jako je SVG a PNG, AddChartFromRanges vytvoří graf z typovaných rozsahů kategorií a hodnot a CheckDataValidations vrací každou buňku, která porušuje pravidla
CheckDataValidation otestuje jeden kandidátní hodnotu proti každému pravidlu ověřování pokrývajícímu buňku, vrátí -1 při platnosti nebo 1-based index prvního porušeného pravidla a volitelně provede zápis jen platného kandidáta
GetCellVisibleFormat rozřeší efektivní formátování listu, řádku, sloupce, range-overlay i explicitní formátování buňky, aniž by vytvořil prázdnou buňku; Subtotal seskupí setříděný rozsah podle změn v jednom sloupci a vloží vzorce mezisoučtů, volitelné vzorce celkových součtů, zděděné formátování a outline úrovně
SortRangeInternal je pokročilý vstupní bod stabilního řazení používaný operacemi rozsahů a sestav; volající by měli obvykle dát přednost SortRange nebo TXLSXRange.Sort
ClearColWidth a ClearRowHeight odeberou explicitní rozměr jednoho sloupce či řádku, takže se vrátí na default listu; doplňují sondy HasColWidth / HasRowHeight
Ovládání uzlů osnovy
TryGetOutlineNode vrací směrově uvědomělý souhrnný uzel, rozsah detailů, úroveň osnovy, hidden stav a explicitní příznak sbalení pro 1-based index řádku či sloupce
SetOutlineNodeCollapsed idempotentně sbalí či rozbalí jeden souhrnný uzel, zatímco SetOutlineDisplayLevel aplikuje 1-based úroveň tlačítka osnovy napříč všemi materializovanými skupinami; obě přijímají xocPreserve, xocCollapse nebo xocExpand pro zacházení s potomky
ToggleRowGrouped a ToggleColGrouped zůstávají kompatibilními obálkami, které přijmou index prvního detailu a skutečný souhrnný uzel rozřeší z SummaryBelow či SummaryRight
Nativní skupiny řádků a sloupců OpenDocument se mapují přes table:display, přežijí přímé metadata a strukturní úpravy a konvertují se na značky souhrnných uzlů XLSX, aniž by si ponechaly příznaky sbalení na úrovni členů; viz Sparse outline geometry
Pojmenované styly a rozpoznávání stylů tabulek
TXLSXRange.ApplyNamedStyle propojí rozsah s pojmenovaným stylem buňky; TXLSXLinkedStyle.AutomaticChoose odvodí dotčené části formátu ze stylu, zatímco LinkedParts vybere font, výplň, ohraničení, formát čísel, zarovnání nebo ochranu explicitně
Editace TXLSXNamedStyle.Style aktualizuje propojené části, aniž by zahodila lokální přepsání, a GetCellVisibleFormat rozřeší výsledek spolu s overlayi listu a styly tabulek, aniž by materializovala prázdné buňky
TXLSXNamedStyles.FindByName najde položku pojmenovaného stylu podle zobrazovaného názvu, aniž byste kolekci prohledávali ručně
Všech 60 vestavěných názvů světlých, středních a tmavých stylů tabulek se rozřeší na kompletní formáty sekcí založené na motivu, sdílené výstupy HTML, PDF, obrázků, preview a vieweru
Převod vzorců
TXLSXCell.ConvertFormulaToValue nahradí jeden vzorec jeho hodnotou v mezipaměti a TXLSXCells.ConvertFormulasToValues aplikuje stejnou operaci na uloženou kolekci buněk
Ověřování zadávaných vzorců
TXLSXWorkbook.FormulaEntryPolicy a TXLSXWorksheet.ValidateFormulaEntry zpřístupňují sdílenou smlouvu pro zadávání vzorců bez mutací, rozlišují prázdný text, neznámé funkce, neznámé názvy, syntaktické chyby a neplatné cíle a rozpoznají registrované uživatelské funkce, aniž by je vyvolaly; viz Formula entry validation policy
Diagnostika úložiště buněk
TXLSXCells.PackedStorageEnabled řídí packed RLE backend používaný kompatibilními typovanými hromadnými zápisy po řádcích a PackedCellCount hlásí buňky tam udržované, dokud přístup na úrovni objektů nezmaterializuje stabilní handly buněk
GetStorageStatistics hlásí bloky řádků, zaplněné řádky a bajtové počty objektů, textů, vzorců, rich-textu, odhadovaných packed, aktivních packed, alokovaných, použitých a packed-string položek pro měřitelná paměťová rozhodnutí; počty style payloadů a ušetřené bajty styled-blank payloadů přímo vystavují copy-on-write sdílení
Podrobnosti automatického filtru
TXLSXAutoFilterColumn.ClearValueFilters vymaže filtry hodnot a skupin dat při zachování položky sloupce
HasCriteria2 a AndConnector popisují vlastní filtry se dvěma podmínkami; filtry barev používají HasColorFilter, HasColorFilter_CellColor a HasColorFilter_DxfId; filtry ikon používají HasIconFilter, HasIconFilter_Set a HasIconFilter_Id
Dynamické filtry používají HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal a HasDynamicFilter_MaxValSet; RawXml zachovává nepodporovaný obsah filtru
Přechodové výplně
TXLSXFill.AddGradientStop připojí zastávku barvy. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount a GradientStops zpřístupňují lineární geometrii nebo geometrii cesty
BackgroundColorTheme, BackgroundColorIndex a BackgroundTintAndShade zachovávají barvy pozadí mimo RGB a TXLSXFills.AddLinearGradient vytvoří a zaregistruje kompletní lineární přechod
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex a ForegroundTintAndShade jsou protějšky pro popředí, které vedle hodnoty RGB zachovávají barvy popředí theme, palette-index a tint-and-shade
Grafy
TXLSXChart zpřístupňuje PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly a kompatibilní fasádu DataLabelsRange, jejíž setter rozesílá hodnotu do současných řad a připravuje pozdější řady, zatímco getter vrací jen společný vzorec per-series
TXLSXChartPlotGroup.Assign kopíruje skupinu vykreslení; ZOrder, BarGrouping, GapWidth a Overlap řídí její pořadí a geometrii pruhů
TXLSXChartSeries zpřístupňuje SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos a LabelPosSet
Popisky řad čerpané z buněk používají DataLabelsRange, DataLabelsCache, ShowDataLabelsRange a ShowDataLabelsRangeSet; SetPointShowDataLabelsRange a TryGetPointShowDataLabelsRange udržují řídké 0-based overridey viditelnosti, zatímco ResolveDataLabelsRange jednou za generaci sešitu obnoví dostupný text listu a externí cache si ponechá bez otevírání datového zdroje
TXLSXChartSeries.CategoriesMultiLevel emituje kategorie c:multiLvlStrRef pro hierarchické popisky os, zatímco výchozí stav ponechává ploché c:strRef / c:numRef
TXLSXChartTrendline zpřístupňuje předpovědní periody Intercept, InterceptSet, Forward a Backward, zatímco TXLSXChartAxis.ShowDispUnitsLabel řídí popisek zobrazovacích jednotek
Podmíněné formáty a ověřování
TXLSXConditionalFormat.ContainsCellFast provádí indexované kontroly členství, HasStyle hlásí diferenciální styl a StdDev, EqualAverage a IsPivot zpřístupňují pokročilé příznaky pravidel
TXLSXConditionalFormat.AcquireWriteGuard vrátí IXLSWorkbookWriteGuard sešitu, takže dávkové úpravy pravidel posunou generaci sešitu jen jednou po dokončení
TXLSXDataValidation.ContainsCellFast provádí ekvivalentní indexovanou kontrolu členství rozsahu ověřování
Tabulky, listy, odkazy, komentáře a kresby
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds a HasHeaderRow zachovávají metadata tabulek s dotazem a bez záhlaví
TXLSXTable.FindFirst a FindNext prohledají dodaný list po řádcích, jejichž pojmenovaný sloupec se rovná hodnotě, a vrátí 1-based řádek nebo 0, s porovnáváním řetězců bez rozlišení velikosti písmen, čísel a booleanů
TXLSXSheets.AddCopy duplikuje list se závislými objekty a ByPos přistupuje ke kolekci podle aktuální pozice karty
TXLSXExternalLink.AddDefinedName a DefinedNameCount udržují externí názvy v mezipaměti a FindDefinedName najde jednu položku podle názvu; read-only vlastnosti RelationshipId, SourceSlot a LinkKind zpřístupňují id relace části externího odkazu, 1-based slot [N] používaný externími vzorci a klasifikaci odkazu (workbook, DDE, OLE nebo unknown); TXLSXHyperlink.TargetFrame zachovává cílový kontext prohlížení
TXLSXDefinedName.UnknownAttributes zachovává nerozpoznané atributy definovaného názvu, takže nepodporovaná rozšíření přežijí Roundtripy
TXLSXComment.AutoSizeFromText upraví velikost tvaru komentáře podle jeho textu a ClearFont odebere explicitní běhy písma formátovaného textu
TXLSXImage.SvgData ukládá doprovodný SVG a CameraRange identifikuje zdrojový rozsah propojeného obrázku; TXLSXTextBox.PrstToken zachovává token předvolené geometrie DrawingML
Obrázky sdílejí payloady bez kopírování bajtů: přiřazení TXLSXImage.Blob (rozhraní IXLSXImageBlob s Data, SvgData, CacheKey, ContentDigest, SvgContentDigest a ByteSize) je cesta bez kopie pro opakované reportové obrázky, digesty se počítají jednou pro media interning při ukládání a read-only TXLSXImage.CacheKey a ContentDigest hlásí přiřazenou identitu; reportová cache odmítne jeden cache key znovu použitý s jinými bajty či formátem
DrawingObjectCount a DrawingObject zpřístupňují jedno stabilní smíšené pořadí napříč obrázky, grafy, textovými poli, zachovanými raw anchory a skupinami; každý TXLSXDrawingObject zpřístupňuje Kind, Parent, ChildCount a TextBox a lze jej přeřadit pomocí BringToFront, SendToBack, BringForward a SendBackward
GroupDrawingObjects vytvoří z vybraných objektů skupinu DrawingML citlivou na transformace a UngroupDrawingObject obnoví její potomky v pořadí, včetně skupin načtených z existujícího balíčku
Klasické protějšky listů
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage a BackgroundImageResource vytvářejí, odstraňují a inspectují pozadí listu BIFF8; bitmapová data se vystavují jako standardní BMP, nativní či neznámé formáty si ponechávají surový payload a kód formátu a známá pozadí se konvertují oběma směry mezi Classic a XLSX enginem
TXLSWorksheet.ConvertFormulasToValues nahrazuje vzorce výsledky v mezipaměti, přetížení OpenRTF importují tabulku RTF do výchozího cíle nebo cíle vybraného volajícím, WriteAutoValue vybere typ buňky z varianty a DefaultFormat zpřístupňuje výchozí XF listu