HotXLS dokumentáció

Speciális XLSX API-tagok

Ezek a tagok a kevésbé gyakori, de nyilvános XLSX szerkesztési felületeket fedik le, amelyek kiegészítik az elsődleges munkafüzet-, munkalap-, tartomány-, stílus-, szűrő- és diagramreferencia-oldalakat

Munkalap-panelek, megjelenítés és háttér

TXLSXWorksheet.SplitPanes és RemoveSplit a felosztott panelek állapotát szerkeszti; a SplitRow, SplitCol, PaneStateKind és ScrollCol a tárolt nézetkoordinátákat teszik elérhetővé

DisplayRowColHeaders a sor- és oszlopfejléceket vezérli, a GridLinesSet megkülönbözteti az explicit rácsvonal-választást az alapértelmezettől, a DefaultFormat és a StyleOverlays pedig a lapszintű stílusállapotot teszik elérhetővé

BackgroundImageData és BackgroundImageFormat a munkalap háttérképét teszik elérhetővé, a BackgroundImageResource háttérsemleges, írásvédett hasznos adatot és formátumleírást biztosít, a ClearBackgroundImage pedig eltávolítja azt

Panelkijelölések és görgetés

A GetSelectedAreas és a panelelőre sorolt SelectAreas túlterhelés a közös TXLSPanePosition típust használja, megőrzi a rendezett és egymást átfedő A1 területeket, és a hívó tulajdonában lévő pillanatfelvételeket ad vissza az aktív terület indexével

Az egész sorokra és oszlopokra kiterjedő szerkezeti szerkesztések minden panelkijelölést átrendeznek, megőrzik a fennmaradó sorrendet és az aktív terület identitását, az aktív terület eltávolításakor pedig determinisztikus rákövetkező, megelőző vagy határcella-tartalékot használnak

A kijelölésnormalizálás, a szerkezeti átrendezés és a pillanatfelvétel-építés egyetlen menetben dolgozó építőket és geometriai kapacitásnövelést használ a nagy területek amortizáltan lineáris feldolgozásához

A TryGetWindowScroll és a ScrollWindow ugyanazokat a logikai paneleket és 1-alapú koordinátákat használja, miközben a teljes sheetView valamint az alsó vagy jobb oldali pane görgetési pozícióit egymástól függetlenül tartja meg

A hiányzó panelek és az érvénytelen frissítések változatlanul hagyják a munkalapot; lásd: Munkalap panelkijelölései és görgetése

Oldaltörés együtt-tartási tartományok

KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether és KeepTogetherCount olyan blokkokat definiálnak, amelyeknek egy oldalon kell maradniuk, ahol a geometria ezt lehetővé teszi

BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow és KeepColBlockBreakCol azt vizsgálja, hogy a javasolt oldaltörések hogyan lépnek kölcsönhatásba ezekkel a blokkokkal

Munkalapszerkesztő segédek

AddImagePair elsődleges képet és tartalék kísérőképet ír, például SVG-t és PNG-t, az AddChartFromRanges típusos kategória- és értéktartományokból épít diagramot, a CheckDataValidations pedig minden szabálysértő cellát visszaad

A CheckDataValidation egy jelölt értéket tesztel a cellát lefedő minden érvényesítési szabályra, érvényes érték esetén -1-et, egyébként az első hibás szabály 1-alapú indexét adja vissza, és opcionálisan csak az érvényes jelöltet véglegesíti

A GetCellVisibleFormat a tényleges munkalap-, sor-, oszlop-, tartományátfedés- és explicit cellaformázást oldja fel üres cella létrehozása nélkül; a Subtotal egy rendezett tartományt egy oszlop változásai szerint csoportosít, és részösszegképleteket, opcionális végösszeg-képleteket, örökölt formázást és vázlatszinteket szúr be

SortRangeInternal a tartomány- és jelentésműveletek által használt speciális stabil rendezés belépési pontja; a hívók általában a SortRange vagy a TXLSXRange.Sort metódust részesítsék előnyben

A ClearColWidth és a ClearRowHeight eltávolítja egy oszlop vagy sor explicit méretét, hogy az visszatérjen a lap alapértelmezéséhez, kiegészítve a HasColWidth / HasRowHeight vizsgálatokat

Vázlatcsomópont-vezérlés

A TryGetOutlineNode az irányfüggő összefoglaló csomópontot, a részlettartományt, a vázlat szintjét, a rejtett állapotot és az explicit összecsukási jelölőt adja vissza egy 1-alapú sor- vagy oszlopindexhez

A SetOutlineNodeCollapsed idempotensen csuk össze vagy nyit ki egy összefoglaló csomópontot, a SetOutlineDisplayLevel pedig az 1-alapú vázlatgomb-szintet alkalmazza minden materializált csoportra; mindkettő elfogadja a xocPreserve, xocCollapse vagy xocExpand gyermekkezelést

A ToggleRowGrouped és a ToggleColGrouped kompatibilitási burkolók maradnak, amelyek az első részletindexet fogadják el, és a tényleges összefoglaló csomópontot a SummaryBelow vagy a SummaryRight alapján oldják fel

A natív OpenDocument sor- és oszlopcsoportok a table:display elemen keresztül képeződnek le, túlélik a közvetlen metaadat- és szerkezetszerkesztéseket, és XLSX összefoglalócsomópont-jelölőkké alakulnak a tag szintű összecsukási jelzők megtartása nélkül; lásd: Ritka vázlatgeometria

Nevesített stílusok és táblastílus-feloldás

A TXLSXRange.ApplyNamedStyle tartományt kapcsol egy nevesített cellastílushoz; a TXLSXLinkedStyle.AutomaticChoose az érintett formátumrészeket a stílusból vezeti le, míg a LinkedParts a betűtípust, a kitöltést, a keretet, a számformátumot, az igazítást vagy a védelmet explicit módon választja ki

A TXLSXNamedStyle.Style szerkesztése a helyi felülírások elvetése nélkül frissíti a kapcsolt részeket, a GetCellVisibleFormat pedig az eredményt a munkalapátfedésekkel és a táblastílusokkal együtt oldja fel üres cellák materializálása nélkül

A TXLSXNamedStyles.FindByName a megjelenített név alapján megkeresi a nevesített stílusbejegyzést a gyűjtemény kézi bejárása nélkül

Mind a 60 beépített világos, közepes és sötét táblastílus-név teljes, témán alapuló szekcióformátumokra oldódik fel, amelyeket a HTML, PDF, kép, előnézet és megjelenítő kimenet közösen használ

Képletátalakítás

TXLSXCell.ConvertFormulaToValue egy képletet a gyorsítótárazott értékére cserél, a TXLSXCells.ConvertFormulasToValues pedig ugyanezt a műveletet alkalmazza a tárolt cellagyűjteményre

Képletbeviteli ellenőrzés

A TXLSXWorkbook.FormulaEntryPolicy és a TXLSXWorksheet.ValidateFormulaEntry a közös, módosításmentes képletbeviteli szerződést teszik elérhetővé, megkülönböztetik az üres szöveget, az ismeretlen függvényeket, az ismeretlen neveket, a szintaxishibákat és az érvénytelen célokat, és a regisztrált felhasználói függvényeket meghívás nélkül ismerik fel; lásd: Képletbeviteli ellenőrzési szabályzat

Cellatárolási diagnosztika

A TXLSXCells.PackedStorageEnabled vezérli a tömörített RLE hátteret, amelyet a kompatibilis, sorfő elrendezésű, típusos tömeges írások használnak, a PackedCellCount pedig az ott megtartott cellákat jelenti, mielőtt az objektumszintű hozzáférés stabil cellafogantyúkat materializálna

A GetStorageStatistics sorblokkokat, kitöltött sorokat, objektum-, szöveg-, képlet-, rich-text-, becsült tömörített, aktív tömörített, lefoglalt, használt és tömörített karakterlánc-bájtszámokat jelent a mérhető memóriadöntésekhez; a stílushasznos-adat számok és a megspórolt stílusos-üres cella bájtok a másoláskor írás megosztását közvetlenül teszik láthatóvá

AutoFilter részletei

TXLSXAutoFilterColumn.ClearValueFilters az érték- és dátumcsoport-szűrőket törli, miközben megtartja az oszlopbejegyzést

HasCriteria2 és AndConnector a kétfeltételes egyéni szűrőket írják le; a színszűrők a HasColorFilter, HasColorFilter_CellColor és HasColorFilter_DxfId elemeket használják; az ikonszűrők a HasIconFilter, HasIconFilter_Set és HasIconFilter_Id elemeket

A dinamikus szűrők a HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal és HasDynamicFilter_MaxValSet elemeket használják; a RawXml a nem támogatott szűrőadatokat őrzi meg

Gradiens kitöltések

TXLSXFill.AddGradientStop színmegállót (color stop) fűz hozzá. A GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount és GradientStops a lineáris vagy útvonal-geometriát teszik elérhetővé

BackgroundColorTheme, BackgroundColorIndex és BackgroundTintAndShade a nem RGB háttérszíneket őrzik meg, a TXLSXFills.AddLinearGradient pedig teljes lineáris gradienst hoz létre és regisztrál

A TXLSXFill.ForegroundColorTheme, ForegroundColorIndex és ForegroundTintAndShade az előtér-megfelelők, amelyek a téma-, palettaindex- és árnyalat-előtérszíneket őrzik meg az RGB érték mellett

Diagramok

TXLSXChart a PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly és DataLabelsRange tagokat teszi elérhetővé

TXLSXChartPlotGroup.Assign egy diagramcsoportot másol; a ZOrder, BarGrouping, GapWidth és Overlap a sorrendjét és az oszlopgeometriáját vezérlik

TXLSXChartSeries a SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos és LabelPosSet tagokat teszi elérhetővé

A soronkénti, cellákból származó címkék a DataLabelsRange, DataLabelsCache, ShowDataLabelsRange és ShowDataLabelsRangeSet tagokat használják; a SetPointShowDataLabelsRange és a TryGetPointShowDataLabelsRange ritka, nullától kezdődő láthatóság-felülírásokat tartanak karban, a ResolveDataLabelsRange pedig munkafüzet-generációnként egyszer frissíti az elérhető munkalapszöveget, és adatforrás megnyitása nélkül megtartja a külső gyorsítótárakat

A TXLSXChartSeries.CategoriesMultiLevel c:multiLvlStrRef kategóriákat bocsát ki a hierarchikus tengelyfeliratokhoz, míg az alapértelmezés a lapos c:strRef / c:numRef kibocsátást fenntartja

A TXLSXChartTrendline az Intercept, InterceptSet, Forward és Backward előrejelzési időszakokat teszi elérhetővé, míg a TXLSXChartAxis.ShowDispUnitsLabel a megjelenítési egységek feliratát vezérli

Feltételes formátumok és érvényesítések

TXLSXConditionalFormat.ContainsCellFast indexelt tagság-ellenőrzéseket végez, a HasStyle differenciálstílust jelent, a StdDev, EqualAverage és IsPivot pedig speciális szabályjelzőket tesznek elérhetővé

A TXLSXConditionalFormat.AcquireWriteGuard a munkafüzet IXLSWorkbookWriteGuard felületét adja vissza, így a kötegelt szabályszerkesztések a befejezéskor egyszer léptetik előre a munkafüzet-generációt

TXLSXDataValidation.ContainsCellFast a megfelelő indexelt érvényesítési tartomány-tagság ellenőrzést végzi

Táblázatok, lapok, hivatkozások, megjegyzések és rajzok

TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds és HasHeaderRow a lekérdezés-támogatott és fejléc nélküli tábla-metaadatokat őrzik meg

A TXLSXTable.FindFirst és FindNext egy hívó által megadott munkalapon keres olyan sorokat, amelyeknek nevesített oszlopa egy adott értékkel egyezik, és 1-alapú sort vagy 0-t ad vissza, kis- és nagybetűfüggetlen szöveg-, szám- és logikai összehasonlításokkal

TXLSXSheets.AddCopy munkalapot másol a függő objektumokkal, a ByPos pedig az aktuális lapfülsorrend szerint éri el a gyűjteményt

A TXLSXExternalLink.AddDefinedName és DefinedNameCount a gyorsítótárazott külső neveket tartják karban, a FindDefinedName pedig név szerint megkeresi az egyik bejegyzést; az írásvédett RelationshipId, SourceSlot és LinkKind tulajdonságok közlik a külső hivatkozásrész kapcsolatazonosítóját, a külső képletek által használt 1-alapú [N] helyet és a hivatkozás besorolását (munkafüzet, DDE, OLE vagy ismeretlen); a TXLSXHyperlink.TargetFrame a cél-böngészési kontextust őrzi meg

A TXLSXDefinedName.UnknownAttributes megőrzi a definiált néven fel nem ismert attribútumokat, így a nem támogatott bővítmények túlélik az oda-vissza konverziókat

TXLSXComment.AutoSizeFromText a megjegyzésalakzatot a szövegéhez méretezi, a ClearFont pedig eltávolítja az explicit rich-text betűtípus-részeket

TXLSXImage.SvgData az SVG kísérőt tárolja, a CameraRange pedig egy hivatkozott kép forrástartományát azonosítja; a TXLSXTextBox.PrstToken a DrawingML előre beállított geometria-tokent őrzi meg

A képek bájtok másolása nélkül osztoznak a hasznos terheken: a TXLSXImage.Blob hozzárendelése (az IXLSXImageBlob felület Data, SvgData, CacheKey, ContentDigest, SvgContentDigest és ByteSize tagokkal) a nulla-másolási útvonal az ismétlődő jelentésképekhez, a kivonatokat a mentéskori médiainterninghez egyszer számolja ki, az írásvédett TXLSXImage.CacheKey és ContentDigest pedig a hozzárendelt azonosságot jelenti; a jelentés-gyorsítótár elutasítja az ugyanazzal a gyorsítótárkulccsal, de eltérő bájtokkal vagy formátumokkal történő újrafelhasználást

A DrawingObjectCount és a DrawingObject egyetlen stabil kevert sorrendet fed le a képek, diagramok, szövegdobozok, megőrzött nyers horgonyok és csoportok között; minden TXLSXDrawingObject elérhetővé teszi a Kind, Parent, ChildCount és TextBox tagokat, és átrendezhető a BringToFront, SendToBack, BringForward és SendBackward hívásokkal

A GroupDrawingObjects transzformációtudatos DrawingML csoportot hoz létre a kijelölt objektumokból, az UngroupDrawingObject pedig sorrendben visszaállítja a gyerekeit, a meglévő csomagból betöltött csoportokat is beleértve

Klasszikus munkalap-megfelelők

A TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage és BackgroundImageResource BIFF8 munkalap-háttereket hoz létre, távolít el és vizsgál; a bittérkép-adatok szabványos BMP-ként érhetők el, a natív vagy ismeretlen formátumok megőrzik nyers hasznos terheiket és formátumkódjukat, az ismert hátterek pedig mindkét irányban konvertálhatók a Classic és az XLSX motor között

TXLSWorksheet.ConvertFormulasToValues a képleteket gyorsítótárazott eredményekre cseréli, az OpenRTF túlterhelések RTF-táblát importálnak az alapértelmezett vagy a hívó által választott célhelyre, a WriteAutoValue egy változatból (variant) választ cellatípust, a DefaultFormat pedig a munkalap alapértelmezett XF-jét teszi elérhetővé

Lásd még