Dokumentacija HotXLS

Napredni članovi XLSX API-ja

Ovi članovi pokrivaju rjeđe ali javne površine uređivanja XLSX-a koje nadopunjuju glavne referentne stranice radne knjige, radnog lista, raspona, stila, filtra i grafikona

Plohe, prikaz i pozadina radnog lista

TXLSXWorksheet.SplitPanes i RemoveSplit uređuju stanje podijeljenih ploha; SplitRow, SplitCol, PaneStateKind i ScrollCol izlažu pohranjene koordinate prikaza

DisplayRowColHeaders upravlja zaglavljima redaka i stupaca, GridLinesSet razlikuje eksplicitan odabir mrežnih linija od zadanog, a DefaultFormat plus StyleOverlays izlažu stanje stila na razini lista

BackgroundImageData i BackgroundImageFormat izlažu pozadinsku sliku radnog lista, a ClearBackgroundImage je uklanja

Rasponi koje treba zadržati zajedno u paginaciji

KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether i KeepTogetherCount definiraju blokove koji bi trebali ostati na jednoj stranici tamo gdje geometrija to dopušta

TXLSXChart izlaže PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly i DataLabelsRange

TXLSXChartPlotGroup.Assign kopira grupu crtanja; ZOrder, BarGrouping, GapWidth i Overlap upravljaju njenim redoslijedom i geometrijom traka

TXLSXChartSeries izlaže SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos i LabelPosSet

TXLSXChartTrendline izlaže Intercept, InterceptSet i Backward, dok TXLSXChartAxis.ShowDispUnitsLabel upravlja oznakom prikaznih jedinica

Uvjetni formati i provjere

TXLSXConditionalFormat.ContainsCellFast izvodi indeksirane provjere članstva, HasStyle izvještava o diferencijalnom stilu, a StdDev, EqualAverage i IsPivot izlažu napredne zastavice pravila

TXLSXDataValidation.ContainsCellFast izvodi ekvivalentnu indeksiranu provjeru članstva u rasponu provjere

Tablice, listovi, veze, komentari i crteži

TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds i HasHeaderRow čuvaju metapodatke tablica koje pokreću upiti i tablica bez zaglavlja

TXLSXSheets.AddCopy duplicira radni list s ovisnim objektima, a ByPos pristupa zbirci prema trenutnoj poziciji kartice

TXLSXExternalLink.AddDefinedName i DefinedNameCount održavaju međuspremljena vanjska imena; TXLSXHyperlink.TargetFrame čuva ciljni kontekst pregledavanja

TXLSXComment.AutoSizeFromText prilagođava veličinu oblika komentara njegovom tekstu, a ClearFont uklanja eksplicitne segmente bogatog teksta fontova

TXLSXImage.SvgData pohranjuje prateći SVG, a CameraRange prepoznaje izvorni raspon povezane slike; TXLSXTextBox.PrstToken čuva token unaprijed postavljene DrawingML geometrije

Klasični ekvivalenti radnog lista

TXLSWorksheet.ConvertFormulasToValues zamjenjuje formule međuspremljenim rezultatima, preopterećenja OpenRTF uvoze RTF tablicu na zadanom ili cilju koji odabere pozivatelj, WriteAutoValue bira tip ćelije iz varijante, a DefaultFormat izlaže zadani XF radnog lista

SetOutlineNodeCollapsed idempotentno sažima ili proširuje jedan sažeti čvor, a SetOutlineDisplayLevel primjenjuje razinu gumba konture s bazom jedan preko svake materijalizirane grupe; oboje prihvaća xocPreserve, xocCollapse ili xocExpand za rukovanje podređenima

ToggleRowGrouped i ToggleColGrouped ostaju wrapper-i kompatibilnosti koji prihvaćaju indeks prvog detalja i razrješavaju stvarni sažeti čvor iz SummaryBelow ili SummaryRight

Izvorne OpenDocument grupe redaka i stupaca preslikavaju se kroz table:display, preživljavaju izravna uređivanja metapodataka i strukture te se pretvaraju u markere sažetih čvorova XLSX-a bez zadržavanja zastavica sažimanja na razini članova; vidi Sparse outline geometry

Imenovani stilovi i razrješavanje stilova tablica

TXLSXRange.ApplyNamedStyle povezuje raspon s imenovanim stilom ćelija; TXLSXLinkedStyle.AutomaticChoose izvodi zahvaćene dijelove formata iz stila, dok LinkedParts izričito bira font, ispunu, okvir, format broja, poravnanje ili zaštitu

Uređivanje TXLSXNamedStyle.Style ažurira povezane dijelove bez odbacivanja lokalnih nadjačavanja, a GetCellVisibleFormat razrješava rezultat zajedno s preklapanjima radnog lista i stilovima tablica bez materijalizacije praznih ćelija

TXLSXNamedStyles.FindByName locira unos imenovanog stila po njegovu prikazanom nazivu bez ručnog pretraživanja zbirke

svih 60 ugrađenih light, medium i dark naziva stilova tablica razrješava se u potpune formate sekcija temeljene na temi koje dijele HTML, PDF, slikovni, pretpregledni i preglednički izlaz

Pretvorba formula

TXLSXCell.ConvertFormulaToValue zamjenjuje jednu formulu njenom predmemoriranom vrijednošću, a TXLSXCells.ConvertFormulasToValues primjenjuje istu operaciju na pohranjenu zbirku ćelija

Validacija unosa formula

TXLSXWorkbook.FormulaEntryPolicy i TXLSXWorksheet.ValidateFormulaEntry izlažu zajednički ugovor unosa formula bez mutacija, razlikuju prazan tekst, nepoznate funkcije, nepoznata imena, sintaksne greške i nevažeće ciljeve te prepoznaju registrirane korisničke funkcije bez njihova pozivanja; vidi Politika validacije unosa formula

Dijagnostika pohrane ćelija

TXLSXCells.PackedStorageEnabled upravlja zapakovanom RLE pozadinom koju koriste kompatibilna tipizirana skupna zapisivanja po redcima, a PackedCellCount izvještava ćelije zadržane tamo prije nego pristup na razini objekata materijalizira stabilne ručke ćelija

GetStorageStatistics izvještava blokove redaka, popunjene retke te bajtove objekata, teksta, formula, bogatog teksta, procijenjenih zapakovanih, aktivnih zapakovanih, alociranih, korištenih i zapakovanih nizova za mjerljive odluke o memoriji; brojevi sadržaja stilova i ušteđeni bajtovi stiliziranih praznih ćelija izravno izlažu copy-on-write dijeljenje

Detalji AutoFiltera

TXLSXAutoFilterColumn.ClearValueFilters briše filtre vrijednosti i grupe datuma uz zadržavanje unosa stupca

HasCriteria2 i AndConnector opisuju prilagođene filtre s dva uvjeta; filtri boja koriste HasColorFilter, HasColorFilter_CellColor i HasColorFilter_DxfId; filtri ikona koriste HasIconFilter, HasIconFilter_Set i HasIconFilter_Id

Dinamički filtri koriste HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal i HasDynamicFilter_MaxValSet; RawXml čuva nepodržani sadržaj filtra

Ispune gradijentom

TXLSXFill.AddGradientStop dodaje zaustavljanje boje. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount i GradientStops izlažu linearnu geometriju ili geometriju putanje

BackgroundColorTheme, BackgroundColorIndex i BackgroundTintAndShade čuvaju pozadinske boje koje nisu RGB, a TXLSXFills.AddLinearGradient stvara i registrira potpuni linearni gradijent

TXLSXFill.ForegroundColorTheme, ForegroundColorIndex i ForegroundTintAndShade su prednji parnjaci, čuvajući boje prednjeg plana teme, indeksa palete i nijanse uz RGB vrijednost

Grafikoni

TXLSXChart izlaže PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly i kompatibilnu fasadu DataLabelsRange čiji setter emitira na trenutne serije i sjeme kasnijim serijama, dok getter vraća samo zajedničku formulu po seriji

TXLSXChartPlotGroup.Assign kopira grupu crtanja; ZOrder, BarGrouping, GapWidth i Overlap upravljaju njezinim redoslijedom i geometrijom trake

TXLSXChartSeries izlaže SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos i LabelPosSet

Naljepnici po seriji s izvorom u ćelijama koriste DataLabelsRange, DataLabelsCache, ShowDataLabelsRange i ShowDataLabelsRangeSet; SetPointShowDataLabelsRange i TryGetPointShowDataLabelsRange održavaju sparse nadjačavanja vidljivosti s bazom nula, dok ResolveDataLabelsRange jednom po generaciji radne knjige osvježava dostupan tekst radnog lista i zadržava vanjske predmemorije bez otvaranja izvora podataka

TXLSXChartSeries.CategoriesMultiLevel emitira kategorije c:multiLvlStrRef za hijerarhijske oznake osi dok default zadržava ravnu emisiju c:strRef / c:numRef

TXLSXChartTrendline izlaže Intercept, InterceptSet, Forward i Backward periode prognoze, a TXLSXChartAxis.ShowDispUnitsLabel upravlja naljepnicom jedinica prikaza

Uvjetni formati i provjere

TXLSXConditionalFormat.ContainsCellFast izvodi indeksirane provjere članstva, HasStyle izvještava diferencijalni stil, a StdDev, EqualAverage i IsPivot izlažu napredne zastavice pravila

TXLSXConditionalFormat.AcquireWriteGuard vraća IXLSWorkbookWriteGuard radne knjige tako da grupna uređivanja pravila jednom napreduju generaciju radne knjige po dovršetku

TXLSXDataValidation.ContainsCellFast izvodi ekvivalentnu indeksiranu provjeru članstva raspona provjere

Tablice, listovi, veze, komentari i crteži

TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds i HasHeaderRow čuvaju metapodatke tablica potkrijepljenih upitima i tablica bez zaglavlja

TXLSXTable.FindFirst i FindNext pretražuju radni list koji zadaje pozivatelj za retke čiji je imenovani stupac jednak vrijednosti, vraćajući redak s bazom jedan ili 0, s usporedbama nizova neosjetljivima na velika i mala slova, numeričkim i boolean usporedbama

TXLSXSheets.AddCopy duplicira radni list s ovisnim objektima, a ByPos pristupa zbirci po trenutnoj poziciji kartice

TXLSXExternalLink.AddDefinedName i DefinedNameCount održavaju predmemorirana vanjska imena, a FindDefinedName locira jedan unos po nazivu; svojstva samo za čitanje RelationshipId, SourceSlot i LinkKind izlažu id relacije dijela vanjske veze, utor [N] s bazom jedan koji koriste vanjske formule i klasifikaciju veze (workbook, DDE, OLE ili unknown); TXLSXHyperlink.TargetFrame čuva ciljni kontekst pregledavanja

TXLSXDefinedName.UnknownAttributes čuva neprepoznate atribute na definiranom imenu tako da nepodržana proširenja prežive Roundtrip

TXLSXComment.AutoSizeFromText dimenzionira oblik komentara prema njegovu tekstu, a ClearFont uklanja izričite segmente fontova bogatog teksta

TXLSXImage.SvgData pohranjuje SVG pratitelja, a CameraRange identificira izvorni raspon povezane slike; TXLSXTextBox.PrstToken čuva token predefinirane geometrije DrawingML-a

Slike dijele sadržaje bez kopiranja bajtova: dodjela TXLSXImage.Blob (sučelje IXLSXImageBlob s Data, SvgData, CacheKey, ContentDigest, SvgContentDigest i ByteSize) jest put bez kopiranja za ponavljane slike izvještaja, sažeci se računaju jednom za interniranje medija pri spremanju, a TXLSXImage.CacheKey i ContentDigest samo za čitanje izvještavaju dodijeljeni identitet; predmemorija izvještaja odbacuje ključ predmemorije ponovno korišten s drugačijim bajtovima ili formatima

DrawingObjectCount i DrawingObject izlažu jedan stabilan mješoviti redoslijed kroz slike, grafikone, tekstne okvire, sačuvana sirova sidra i grupe; svaki TXLSXDrawingObject izlaže Kind, Parent, ChildCount i TextBox te se može preurediti s BringToFront, SendToBack, BringForward i SendBackward

GroupDrawingObjects stvara grupu DrawingML-a osjetljivu na transformacije od odabranih objekata, a UngroupDrawingObject vraća njegovu djecu redom, uključujući grupe učitane iz postojećeg paketa

Klasični parnjaci radnog lista

TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage i BackgroundImageResource pišu, uklanjaju i pregledavaju pozadine radnog lista BIFF8; bitmap podaci izlažu se kao standardni BMP, izvorni i nepoznati formati zadržavaju svoj sirovi sadržaj i kod formata, a poznate pozadine pretvaraju se u oba smjera između Classic i XLSX pogona

TXLSWorksheet.ConvertFormulasToValues zamjenjuje formule predmemoriranim rezultatima, preopterećenja OpenRTF uvoze RTF tablicu na zadani ili pozivateljem odabrani cilj, WriteAutoValue bira tip ćelije iz varijante, a DefaultFormat izlaže zadani XF radnog lista

Vidi također