Разширени XLSX API членове
Тези членове обхващат по-рядко срещани, но публични XLSX повърхности за редактиране, които допълват основните справочни страници за работната книга, работния лист, диапазона, стила, филтъра и диаграмите
Панели на работния лист, показване и фон
TXLSXWorksheet.SplitPanes и RemoveSplit редактират състоянието на разделените панели; SplitRow, SplitCol, PaneStateKind и ScrollCol разкриват съхранените координати на изгледа
DisplayRowColHeaders контролира заглавията на редовете и колоните, GridLinesSet разграничава изричен избор на мрежови линии от подразбиращия се, а DefaultFormat плюс StyleOverlays разкриват състоянието на стила на ниво лист
BackgroundImageData и BackgroundImageFormat разкриват фоновото изображение на работния лист, докато ClearBackgroundImage го премахва
Избор на панели и скролиране
GetSelectedAreas и pane-first претоварването SelectAreas използват споделения тип TXLSPanePosition, запазват подредени и застъпващи се A1 области и връщат снимки, притежавани от извикващия код, с индекса на активната област
Структурните редакции на цели редове и цели колони пренасочват всеки избор на панел, запазват оцелелите подредба и идентичност на активната област и използват детерминирани fallback-и към наследник, предшественик или гранична клетка, когато активната област е изтрита
Нормализацията на избора, структурното пренасочване и изграждането на снимки използват еднопроходни конструктори и геометрично нарастване на капацитета за амортизирано-линейна обработка на големи области
TryGetWindowScroll и ScrollWindow използват същите логически панели и 1-базирани координати, като запазват независимо общата позиция за скролиране на sheetView и на долния или десния pane
Липсващи панели и невалидни обновявания оставят работния лист непроменен; вижте Избори на панели в работния лист и скролиране
Диапазони, запазвани заедно при пагинация
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether и KeepTogetherCount дефинират блокове, които трябва да останат на една страница, когато геометрията го позволява
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow и KeepColBlockBreakCol инспектират как предложените прекъсвания на страници взаимодействат с тези блокове
Помощници за редактиране на работни листове
AddImagePair записва основно изображение плюс придружаващ фолбек, като SVG и PNG, AddChartFromRanges изгражда диаграма от типизирани диапазони на категории и стойности, а CheckDataValidations връща всяка нарушаваща клетка
CheckDataValidation проверява една кандидат-стойност срещу всяко правило за валидиране, покриващо клетката, връща -1 при валидна или 1-базирания индекс на първото нарушаващо правило и по избор записва само валиден кандидат
GetCellVisibleFormat разрешава ефективното форматиране на листа, реда, колоната, наслагванията на диапазона и изричното форматиране на клетката, без да създава празна клетка; Subtotal групира сортиран диапазон по промените в една колона и вмъква междинни формули, незадължителни формули за обща сума, наследено форматиране и нива на структура
SortRangeInternal е разширената точка на влизане за стабилно сортиране, използвана от операциите за диапазони и отчети; извикващите код обикновено трябва да предпочитат SortRange или TXLSXRange.Sort
ClearColWidth и ClearRowHeight премахват изричното измерение на една колона или ред, така че то се връща към подразбиращото се за листа, допълвайки проверките HasColWidth / HasRowHeight
Управление на възлите на структурата
TryGetOutlineNode връща зависимия от посоката възел на обобщение, диапазона на подробностите, нивото на структурата, състоянието скрито и изричната маркировка за свиване за индекс на ред или колона, броен от единица
SetOutlineNodeCollapsed idempotently свива или разгъва един възел на обобщение, а SetOutlineDisplayLevel прилага нивото на бутона за структура (броено от единица) върху всяка материализирана група; и двата приемат xocPreserve, xocCollapse или xocExpand за обработка на децата
ToggleRowGrouped и ToggleColGrouped остават съвместими обвивки, които приемат първия индекс на подробностите и разрешават реалния възел на обобщение от SummaryBelow или SummaryRight
Родните групи редове и колони на OpenDocument се преобразуват чрез table:display, оцеляват при директни метаданни и структурни редакции и се конвертират в маркери за възели на обобщение на XLSX, без да запазват флагове за свиване на членове; вижте Геометрия на рядката структура
Именувани стилове и разрешаване на таблични стилове
TXLSXRange.ApplyNamedStyle свързва диапазон с именуван клетъчен стил; TXLSXLinkedStyle.AutomaticChoose извежда засегнатите части от формата от стила, докато LinkedParts избира изрично шрифт, запълване, граница, числов формат, подравняване или защита
Редактирането на TXLSXNamedStyle.Style обновява свързаните части, без да изхвърля локалните презаписи, а GetCellVisibleFormat разрешава резултата заедно с наслагванията на листа и табличните стилове, без да материализира празни клетки
TXLSXNamedStyles.FindByName намира запис на именуван стил по показваното му име, без ръчно обхождане на колекцията
Всичките 60 вградени имена на таблични стилове light, medium и dark се разрешават до пълни секционни формати, базирани на темата, споделяни от HTML, PDF, image, preview и viewer изхода
Преобразуване на формули
TXLSXCell.ConvertFormulaToValue заменя една формула с нейната кеширана стойност, а TXLSXCells.ConvertFormulasToValues прилага същата операция към съхранената колекция от клетки
Валидиране на въвеждане на формули
TXLSXWorkbook.FormulaEntryPolicy и TXLSXWorksheet.ValidateFormulaEntry разкриват общия договор за въвеждане на формули без мутации, разграничават празен текст, неизвестни функции, неизвестни имена, синтактични грешки и невалидни цели и разпознават регистрирани потребителски функции, без да ги извикват; вижте Политика за валидиране на въвеждане на формули
Диагностика на съхранението на клетки
TXLSXCells.PackedStorageEnabled контролира pack-вания RLE бекенд, използван от съвместимите row-major типизирани групови записи, а PackedCellCount докладва клетките, задържани там, преди обектният достъп да материализира стабилни клетъчни дръжки
GetStorageStatistics докладва блокове редове, попълнени редове, броячи на обекти, текст, формули, rich text, оценени pack-вани, активни pack-вани, заделени, използвани и pack-вани низови байтове за измерими решения за паметта; броячите на стилови payload обекти и спестените байтове от стилизирани празни клетки разкриват директно copy-on-write споделянето
Подробности за автофилтъра
TXLSXAutoFilterColumn.ClearValueFilters изчиства филтрите по стойности и групи по дати, като запазва записа на колоната
HasCriteria2 и AndConnector описват персонализирани филтри с две условия; цветовите филтри използват HasColorFilter, HasColorFilter_CellColor и HasColorFilter_DxfId; филтрите с икони използват HasIconFilter, HasIconFilter_Set и HasIconFilter_Id
Динамичните филтри използват HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal и HasDynamicFilter_MaxValSet; RawXml запазва неподдържания полезен товар на филтъра
Градиентни запълвания
TXLSXFill.AddGradientStop добавя цветова точка. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount и GradientStops разкриват линейна или пътна геометрия
BackgroundColorTheme, BackgroundColorIndex и BackgroundTintAndShade запазват фонови цветове, които не са RGB, а TXLSXFills.AddLinearGradient създава и регистрира пълен линеен градиент
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex и ForegroundTintAndShade са фоновите двойници, запазващи цветове на преден план от тип тема, индекс в палитрата и tint-and-shade до RGB стойността
Диаграми
TXLSXChart разкрива PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly и съвместимата фасада DataLabelsRange, чийто setter разпръсква по текущите серии и подготвя следващите, а getter-ът връща само обща формула за серия
TXLSXChartPlotGroup.Assign копира група от графики; ZOrder, BarGrouping, GapWidth и Overlap контролират нейното подреждане и геометрията на лентите
TXLSXChartSeries разкрива SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos и LabelPosSet
Етикетите на серия, идващи от клетки, използват DataLabelsRange, DataLabelsCache, ShowDataLabelsRange и ShowDataLabelsRangeSet; SetPointShowDataLabelsRange и TryGetPointShowDataLabelsRange поддържат редки презаписи на видимост (броени от нула), а ResolveDataLabelsRange обновява достъпния текст на работния лист веднъж на генерация на работната книга и запазва външни кешове, без да отваря източник на данни
TXLSXChartSeries.CategoriesMultiLevel изписва категории c:multiLvlStrRef за йерархични етикети на осите, докато по подразбиране остава flat изписването с c:strRef / c:numRef
TXLSXChartTrendline разкрива Intercept, InterceptSet, Forward и Backward периоди за прогноза, докато TXLSXChartAxis.ShowDispUnitsLabel контролира етикета на единиците за показване
Условни формати и валидации
TXLSXConditionalFormat.ContainsCellFast извършва индексирани проверки за членство, HasStyle отчита диференциален стил, а StdDev, EqualAverage и IsPivot разкриват разширени флагове на правила
TXLSXConditionalFormat.AcquireWriteGuard връща IXLSWorkbookWriteGuard на работната книга, така че груповите редакции на правила повишават генерацията на работната книга еднократно при завършване
TXLSXDataValidation.ContainsCellFast извършва еквивалентната индексирана проверка за членство в диапазона за валидиране
Таблици, листове, връзки, коментари и рисунки
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds и HasHeaderRow запазват метаданните на таблици, поддържани от заявки и без заглавие
TXLSXTable.FindFirst и FindNext сканират подаден от извикващия работен лист за редове, чьято именувана колона е равна на стойност, и връщат 1-базиран ред или 0, със сравнения на низове, числа и boolean без регистрова чувствителност
TXLSXSheets.AddCopy дублира работен лист със зависими обекти, а ByPos осъществява достъп до колекцията по текущата позиция на раздела
TXLSXExternalLink.AddDefinedName и DefinedNameCount поддържат кеширани външни имена, а FindDefinedName намира запис по име; read-only свойствата RelationshipId, SourceSlot и LinkKind разкриват идентификатора на релацията на частта за външна връзка, 1-базирания слот [N], използван от външните формули, и класификацията на връзката (работна книга, DDE, OLE или неизвестна); TXLSXHyperlink.TargetFrame запазва целевия контекст за сърфиране
TXLSXDefinedName.UnknownAttributes запазва неразпознатите атрибути на дефинирано име, така че неподдържаните разширения оцеляват при roundtrip
TXLSXComment.AutoSizeFromText оразмерява формата на коментара според текста му, а ClearFont премахва изричните сегменти на богатия текст на шрифта
TXLSXImage.SvgData съхранява придружаващия SVG, а CameraRange идентифицира изходния диапазон на свързано изображение; TXLSXTextBox.PrstToken запазва токена на предварително зададената геометрия на DrawingML
Изображенията споделят payload обекти без копиране на байтове: присвояването на TXLSXImage.Blob (интерфейсът IXLSXImageBlob с Data, SvgData, CacheKey, ContentDigest, SvgContentDigest и ByteSize) е zero-copy пътят за повтарящи се отчетни изображения, дайджестите се изчисляват веднъж за interning на медия при запис, а read-only TXLSXImage.CacheKey и ContentDigest докладват присвоената идентичност; отчетният кеш отхвърля един cache key, използван повторно с различни байтове или формати
DrawingObjectCount и DrawingObject разкриват един стабилен смесен ред на изображения, диаграми, текстови полета, запазени сурови котви и групи; всеки TXLSXDrawingObject разкрива Kind, Parent, ChildCount и TextBox и може да се пренареди с BringToFront, SendToBack, BringForward и SendBackward
GroupDrawingObjects създава трансформация-съзнателна DrawingML група от избрани обекти, а UngroupDrawingObject възстановява децата ѝ в ред, включително групи, заредени от съществуващ пакет
Класически аналози на работния лист
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage и BackgroundImageResource създават, премахват и инспектират фонове на работен лист в BIFF8; bitmap данните се разкриват като стандартен BMP, родните или неизвестни формати запазват суровия си payload и код на формата, а известните фонове се конвертират и в двете посоки между Classic и XLSX engineите
TXLSWorksheet.ConvertFormulasToValues заменя формулите с кеширани резултати, претоварванията на OpenRTF импортират RTF таблица в подразбиращата се или избрана от извикващия код цел, WriteAutoValue избира тип на клетката от вариант, а DefaultFormat разкрива подразбиращия се XF на работния лист