Dokumentacija HotXLS

Napredni člani API-ja XLSX

Ti člani pokrivajo manj pogoste, a javne površine urejanja XLSX, ki dopolnjujejo glavne referenčne strani delovnega zvezka, delovnega lista, obsega, sloga, filtra in grafikonov

Deli, prikaz in ozadje delovnega lista

TXLSXWorksheet.SplitPanes in RemoveSplit urejata stanje razdeljenih delov; SplitRow, SplitCol, PaneStateKindin ScrollCol izpostavljajo shranjene koordinate pogleda

DisplayRowColHeaders nadzira naslove vrstic in stolpcev, GridLinesSet loči eksplicitno izbiro mrežnih črt od privzete, DefaultFormat in StyleOverlays pa izpostavljata stanje slogov na ravni lista

BackgroundImageData in BackgroundImageFormat izpostavljata sliko ozadja delovnega lista, BackgroundImageResource pa jo odstrani ClearBackgroundImage removes it

Pane selections and scrolling

GetSelectedAreas and the pane-first SelectAreas overload use the shared TXLSPanePosition vrsto, ohranijo urejena in prekrivajoča se območja A1 in vrnejo posnetke v lasti klicatelja z indeksom aktivnega območja

Strukturne spremembe celih vrstic in celih stolpcev znova preslikajo vsako izbiro podoknov, ohranijo preživeli vrstni red in identiteto aktivnega območja in uporabijo deterministične rezerve naslednika, predhodnika ali robne celice, ko je aktivno območje odstranjeno

Normalizacija izbire, strukturno preslikavanje in izgradnja posnetkov uporabljajo enoprehodne graditelje in geometrijsko rast zmogljivosti za obdelavo velikih območij z amortizirano linearnostjo

TryGetWindowScroll and ScrollWindow uporabljajo ista logična podokna in koordinate z enaštetjem, hkrati pa ohranijo skupni sheetView and lower or right pane scroll positions independently

Manjkajoča podokna in neveljavne posodobitve pustijo delovni list nespremenjen; glej Worksheet pane selections and scrolling

Obsegi, ki ostanejo skupaj pri paginaciji

KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogetherin KeepTogetherCount določajo bloke, ki naj ostanejo na eni strani, kjer geometrija to dopušča

BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRowin KeepColBlockBreakCol preverijo, kako predlagani prelomi strani vplivajo na te bloke

Pomožne funkcije urejanja delovnega lista

AddImagePair zapiše glavno sliko in spremljevalno rezervno sliko, kot sta SVG in PNG, AddChartFromRanges zgradi grafikon iz tipiziranih obsegov kategorij in vrednosti, CheckDataValidations pa vrne vsako celico, ki krši pravila

CheckDataValidation je napredna vstopna točka stabilnega razvrščanja, ki jo uporabljajo operacije obsegov in poročil; klicatelji naj običajno raje uporabijo -1 ali

GetCellVisibleFormat razreši učinkovito oblikovanje delovnega lista, vrstice, stolpca, preklopa obsega in izrecno oblikovanje celice, brez ustvarjanja prazne celice; Subtotal razvrščen obseg grupira po spremembah v enem stolpcu in vstavi vmesne formule, neobvezne formule skupne vsote, podedovano oblikovanje in nivoje orisa

SortRangeInternal je napredna vstopna točka stabilnega razvrščanja, ki jo uporabljajo operacije obsegov in poročil; klicatelji naj običajno raje uporabijo SortRange or TXLSXRange.Sort

ClearColWidth and ClearRowHeight odstranijo izrecno dimenzijo stolpca ali vrstice, tako da ta pade nazaj na privzeto vrednost lista, in dopolnjujejo HasColWidth / HasRowHeight probes

Pretvorba formul

TryGetOutlineNode zamenja eno formulo z njeno predpomnjeno vrednostjo,

SetOutlineNodeCollapsed idempotentno sesede ali razpre eno vozlišče povzetka, medtem ko SetOutlineDisplayLevel uporabi raven orisnega gumba z enaštetjem čez vsako materializirano skupino; obe sprejmeta xocPreserve, xocCollapse, or xocExpand child handling

ToggleRowGrouped and ToggleColGrouped ostanejo združljivostni ovijalniki, ki sprejmejo indeks prve podrobnosti in dejansko vozlišče povzetka razrešijo iz SummaryBelow or SummaryRight

Domače skupine vrstic in stolpcev OpenDocument se preslikajo prek table:display, preživijo neposredne spremembe metapodatkov in strukture ter se pretvorijo v označevalce vozlišč povzetkov XLSX, brez ohranjanja zastavic sesedanja na ravni članov; glej Sparse outline geometry

Named styles and table-style resolution

TXLSXRange.ApplyNamedStyle links a range to a named cell style; TXLSXLinkedStyle.AutomaticChoose prizadete dele oblike izvode iz stila, medtem ko LinkedParts izrecno izbere pisavo, polnilo, obrobo, obliko števil, poravnavo ali zaščito

Editing TXLSXNamedStyle.Style posodobi povezane dele, brez zavrženja krajevnih preglasitev, in GetCellVisibleFormat razreši rezultat skupaj s preklopi delovnega lista in stili tabel, brez materializacije praznih celic

TXLSXNamedStyles.FindByName poišče vnos poimenovanega stila po njegovem prikazanem imenu, brez ročnega prečesavanja zbirke

Vsa 60 vgrajenih imen stilov tabel light, medium in dark se razreši v popolne formate odsekov na osnovi tem, ki jih si delijo izhodi HTML, PDF, slike, predogled in pregledovalnik

Formula conversion

TXLSXCell.ConvertFormulaToValue eno formulo zamenja z njeno predpomnjeno vrednostjo in TXLSXCells.ConvertFormulasToValues isto operacijo uporabi na shranjeni zbirki celic

Formula entry validation

TXLSXWorkbook.FormulaEntryPolicy and TXLSXWorksheet.ValidateFormulaEntry razkrijejo skupno pogodbo vnosov formul brez sprememb, ločijo prazno besedilo, neznane funkcije, neznana imena, sintaktične napake in neveljavne cilje ter prepoznajo registrirane uporabniške funkcije, brez da bi jih poklicali; glej Formula entry validation policy

Cell storage diagnostics

TXLSXCells.PackedStorageEnabled nadzoruje zaledje stisnjenega RLE, ki ga uporabljajo združljivi tipizirani množični zapisi, vrstica-prva, in PackedCellCount poroča o celicah, ohranjenih tam, preden dostop na ravni objektov materializira stabilne ročaje celic

GetStorageStatistics pa uporabi isto operacijo za shranjeno zbirko celic

Podrobnosti samodejnega filtra

TXLSXAutoFilterColumn.ClearValueFilters počisti filtre vrednosti in datumskih skupin ob ohranjanju vnosa stolpca

HasCriteria2 in AndConnector opisujeta filtre po meri z dvema pogojema; barvni filtri uporabljajo HasColorFilter, HasColorFilter_CellColorin HasColorFilter_DxfId; ikonski filtri uporabljajo HasIconFilter, HasIconFilter_Setin HasIconFilter_Id

Dinamični filtri uporabljajo HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxValin HasDynamicFilter_MaxValSet; RawXml ohranja nepodprto vsebino filtra

Gradientna polnila

TXLSXFill.AddGradientStop doda barvno postajo. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCountin GradientStops izpostavljajo linearno geometrijo ali geometrijo poti

BackgroundColorTheme, BackgroundColorIndexin BackgroundTintAndShade ohranjajo barve ozadja, ki niso RGB, TXLSXFills.AddLinearGradient pa ustvari in registrira celoten linearni gradient

TXLSXFill.ForegroundColorTheme, ForegroundColorIndex, and ForegroundTintAndShade so ustrezniki za ospredje in poleg vrednosti RGB ohranijo barve ospredja teme, indeksa palete ter odtenek-in-senco

Grafikoni

TXLSXChart izpostavlja PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnlyin DataLabelsRange fasada, pri kateri nastavitvena metoda razglasi na trenutne serije in pripravi kasnejše serije, vračalna metoda pa vrne le skupno formulo na serijo

TXLSXChartPlotGroup.Assign kopira skupino grafov; ZOrder, BarGrouping, GapWidthin Overlap nadzorujejo njeno razvrščanje in geometrijo stolpcev

TXLSXChartSeries izpostavlja SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPosin LabelPosSet

Per-series cell-sourced labels use DataLabelsRange, DataLabelsCache, ShowDataLabelsRange, and ShowDataLabelsRangeSet; SetPointShowDataLabelsRange and TryGetPointShowDataLabelsRange vzdržujejo redke preglasitve vidnosti z ničštetjem, medtem ko ResolveDataLabelsRange osveži dostopno besedilo delovnega lista enkrat na generacijo delovnega zvezka in ohrani zunanje predpomnilnike, brez odpiranja podatkovnega vira

TXLSXChartSeries.CategoriesMultiLevel emits c:multiLvlStrRef kategorije za hierarhične oznake osi, medtem ko privzeta vrednost ohrani ravno c:strRef / c:numRef emission

TXLSXChartTrendline exposes Interceptizpostavlja InterceptSet, Forwardin Backward , medtem ko TXLSXChartAxis.ShowDispUnitsLabel nadzira oznako prikazanih enot

Pogojna oblikovanja in preverjanja

TXLSXConditionalFormat.ContainsCellFast izvaja indeksirane preveritve pripadnosti, HasStyle poroča o diferencialnem slogu, StdDev, EqualAverage, and IsPivot expose advanced rule flags

TXLSXConditionalFormat.AcquireWriteGuard in IXLSWorkbookWriteGuard pa izpostavljajo napredne zastavice pravil

TXLSXDataValidation.ContainsCellFast izvaja enakovredno indeksirano preverjanje pripadnosti obsegu preverjanja

Tabele, listi, povezave, pripombe in risbe

TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIdsin HasHeaderRow ohranjajo metapodatke tabel, podprtih s poizvedbami, in tabel brez glave

TXLSXTable.FindFirst podvoji delovni list s soodvisnimi objekti, FindNext pa dostopa do zbirke po trenutnem položaju zavihka

TXLSXSheets.AddCopy in ByPos vzdržujeta predpomnjene zunanje sklice;

TXLSXExternalLink.AddDefinedName and DefinedNameCount maintain cached external names and FindDefinedName poišče en vnos po imenu; RelationshipId, SourceSlot, and LinkKind lastnosti razkrijejo id relacije dela zunanje povezave, [N] režo, ki jo uporabljajo zunanje formule, in klasifikacijo povezave (delovni zvezek, DDE, OLE ali neznano); TXLSXHyperlink.TargetFrame preserves the target browsing context

TXLSXDefinedName.UnknownAttributes ohranja ciljni kontekst brskanja

TXLSXComment.AutoSizeFromText prilagodi obliko pripombe njenemu besedilu, ClearFont pa odstrani eksplicitne dele pisave obogatenega besedila

TXLSXImage.SvgData shranjuje spremljevalno sliko SVG, CameraRange pa določi izvorni obseg povezane slike; TXLSXTextBox.PrstToken ohranja žeton vnaprej določene geometrije DrawingML

Slike si tovore delijo brez kopiranja bajtov: dodelitev TXLSXImage.Blob (the IXLSXImageBlob interface with Data, SvgData, CacheKey, ContentDigest, SvgContentDigest, and ByteSize) je pot brez kopiranja za ponavljajoče sike poročil, prebave se izračunajo enkrat za interniranje medijev ob shranjevanju, TXLSXImage.CacheKey and ContentDigest poročajo o dodeljeni identiteti; predpomnilnik poročil zavrne isti ključ predpomnilnika, ponovno uporabljen z drugačnimi bajti ali oblikami

DrawingObjectCount and DrawingObject razkrijejo enak stabilen mešani vrstni red čez slike, grafikone, besedilna polja, ohranjena surova sidra in skupine; vsak TXLSXDrawingObject exposes Kind, Parent, ChildCount, and TextBox, and can be reordered with BringToFront, SendToBack, BringForward, and SendBackward

GroupDrawingObjects izbranih objektov ustvari skupino DrawingML, ki upošteva transformacije, in UngroupDrawingObject obnovi njegove otroke v vrstnem redu, vključno s skupinami, naloženimi iz obstoječega paketa

Klasični dvojniki delovnega lista

TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage, and BackgroundImageResource ustvarjajo, odstranjujejo in pregledujejo ozadja delovnih listov BIFF8; podatki bitne slike so razkriti kot običajni BMP, domače ali neznane oblike ohranijo svoj surovi tovor in kodo oblike, znana ozadja pa se pretvorijo v obe smeri med strojema Classic in XLSX

TXLSWorksheet.ConvertFormulasToValues zamenja formule s predpomnjenimi rezultati, preobtežene metode OpenRTF uvozijo tabelo RTF na privzeti cilj ali cilj, ki ga izbere klicatelj, WriteAutoValue izbere tip celice iz različice, DefaultFormat pa izpostavlja privzeti XF delovnega lista

Glej tudi