Προηγμένα μέλη API XLSX

Αυτά τα μέλη καλύπτουν λιγότερο συνηθισμένες αλλά δημόσιες επιφάνειες επεξεργασίας XLSX που συμπληρώνουν τις κύριες σελίδες αναφοράς βιβλίου εργασίας, φύλλου εργασίας, εύρους, στυλ, φίλτρου και γραφήματος

Τμήματα φύλλου εργασίας, εμφάνιση και φόντο

Τα TXLSXWorksheet.SplitPanes και RemoveSplit επεξεργάζονται την κατάσταση διαχωρισμένων τμημάτων· τα SplitRow, SplitCol, PaneStateKind και ScrollCol εκθέτουν τις αποθηκευμένες συντεταγμένες προβολής

Το DisplayRowColHeaders ελέγχει τις επικεφαλίδες σειρών και στηλών, το GridLinesSet διακρίνει μια ρητή επιλογή γραμμών πλέγματος από την προεπιλογή και τα DefaultFormat συν StyleOverlays εκθέτουν την κατάσταση στυλ σε επίπεδο φύλλου

Τα BackgroundImageData και BackgroundImageFormat εκθέτουν την εικόνα φόντου του φύλλου εργασίας, το BackgroundImageResource παρέχει ένα payload και περιγραφή μορφής μόνο για ανάγνωση, ανεξάρτητα από backend, και το ClearBackgroundImage την αφαιρεί

Επιλογές τμημάτων και κύλιση

Η GetSelectedAreas και το overload της SelectAreas με τα τμήματα πρώτα χρησιμοποιούν τον κοινό τύπο TXLSPanePosition, διατηρούν διατεταγμένες και επικαλυπτόμενες περιοχές A1, και επιστρέφουν στιγμιότυπα ιδιοκτησίας του καλούντα με τον δείκτη της ενεργού περιοχής

Οι δομικές επεξεργασίες ολόκληρων γραμμών και στηλών επαντιτοπίζουν κάθε επιλογή τμήματος, διατηρούν τη σειρά των επιζώντων και την ταυτότητα της ενεργού περιοχής, και χρησιμοποιούν ντετερμινιστικά πρόσθια, οπισθία ή όρια-κελιού fallback όταν η ενεργή περιοχή αφαιρείται

Η κανονικοποίηση επιλογών, η δομική επαντιτοπισμός και η κατασκευή στιγμιότυπων χρησιμοποιούν one-pass builders και γεωμετρική αύξηση χωρητικότητας για επεξεργασία μεγάλων περιοχών με amortized-γραμμικό κόστος

Τα TryGetWindowScroll και ScrollWindow χρησιμοποιούν τα ίδια λογικά τμήματα και συντεταγμένες με βάση το 1, διατηρώντας τη συνολική sheetView και τις θέσεις κύλισης του κάτω ή δεξιού pane ανεξάρτητα

Ελλιπή τμήματα και άκυρες ενημερώσεις αφήνουν το φύλλο εργασίας αμετάβλητο· δείτε Επιλογές τμημάτων και κύλιση φύλλου εργασίας

Περιοχές παραμονής μαζί στη σελιδοποίηση

Τα KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether και KeepTogetherCount ορίζουν μπλοκ που θα πρέπει να παραμένουν σε μία σελίδα όπου το επιτρέπει η γεωμετρία

Τα BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow και KeepColBlockBreakCol εξετάζουν πώς οι προτεινόμενες αλλαγές σελίδας αλληλεπιδρούν με αυτά τα μπλοκ

Βοηθοί επεξεργασίας φύλλου εργασίας

Το AddImagePair γράφει μια κύρια εικόνα συν ένα συνοδευτικό εναλλακτικό όπως SVG και PNG, το AddChartFromRanges δημιουργεί ένα γράφημα από τυποποιημένες περιοχές κατηγοριών και τιμών και το CheckDataValidations επιστρέφει κάθε κελί που παραβιάζει κανόνες

Το CheckDataValidation ελέγχει μία υποψήφια τιμή έναντι κάθε κανόνα επικύρωσης που καλύπτει ένα κελί, επιστρέφει -1 όταν είναι έγκυρη ή τον δείκτη με βάση το 1 του πρώτου κανόνα που αποτυγχάνει, και προαιρετικά δεσμεύει μόνο έγκυρη υποψήφια τιμή

Η GetCellVisibleFormat επιλύει την effective μορφοποίηση φύλλου, γραμμής, στήλης, overlay περιοχής και ρητή μορφοποίηση κελιού χωρίς να δημιουργήσει κενό κελί· η Subtotal ομαδοποιεί ένα ταξινομημένο εύρος βάσει των αλλαγών μιας στήλης και εισάγει τύπους υποσυνόλων, προαιρετικούς τύπους γενικών συνόλων, κληρονομημένη μορφοποίηση και επίπεδα outline

Το SortRangeInternal είναι το προηγμένο σημείο εισόδου σταθερής ταξινόμησης που χρησιμοποιείται από λειτουργίες εύρους και αναφορών· οι καλούντες θα πρέπει κανονικά να προτιμούν το SortRange ή το TXLSXRange.Sort

Τα ClearColWidth και ClearRowHeight αφαιρούν τη ρητή διάσταση μιας στήλης ή γραμμής ώστε να επανέλθει στην προεπιλογή του φύλλου, συμπληρώνοντας τις ελέγχους HasColWidth / HasRowHeight

Έλεγχος outline κόμβων

Η TryGetOutlineNode επιστρέφει τον direction-aware κόμβο σύνοψης, το εύρος λεπτομερειών, το επίπεδο outline, την κατάσταση απόκρυψης και τον ρητό δείκτη σύμπτυξης για δείκτη γραμμής ή στήλης με βάση το 1

Η SetOutlineNodeCollapsed συμπτύσσει ή αναπτύσσει idempotently έναν κόμβο σύνοψης, ενώ η SetOutlineDisplayLevel εφαρμόζει το επίπεδο κουμπιού outline με βάση το 1 σε κάθε υλοποιημένη ομάδα· και οι δύο δέχονται χειρισμό παιδιών xocPreserve, xocCollapse ή xocExpand

Τα ToggleRowGrouped και ToggleColGrouped παραμένουν wrappers συμβατότητας που δέχονται τον πρώτο δείκτη λεπτομερειών και επιλύουν τον πραγματικό κόμβο σύνοψης από το SummaryBelow ή το SummaryRight

Οι εγγενείς ομάδες γραμμών και στηλών του OpenDocument αντιστοιχίζονται μέσω του table:display, επιβιώνουν από απευθείας επεξεργασίες μεταδεδομένων και δομικές επεξεργασίες, και μετατρέπονται σε δείκτες κόμβων σύνοψης XLSX χωρίς να διατηρούν σημαίες σύμπτυξης επιπέδου μελών· δείτε Αραιή γεωμετρία outline

Ονομασμένα στυλ και επίλυση στυλ πίνακα

Η TXLSXRange.ApplyNamedStyle συνδέει ένα εύρος με ένα ονομασμένο στυλ κελιού· η TXLSXLinkedStyle.AutomaticChoose συμπεραίνει τα επηρεαζόμενα μέρη μορφοποίησης από το στυλ, ενώ τα LinkedParts επιλέγουν ρητά γραμματοσειρά, γέμισμα, περίγραμμα, μορφή αριθμών, στοίχιση ή προστασία

Η επεξεργασία του TXLSXNamedStyle.Style ενημερώνει τα συνδεδεμένα μέρη χωρίς να απορρίπτει τοπικές παρακάμψεις, και η GetCellVisibleFormat επιλύει το αποτέλεσμα μαζί με τα overlays του φύλλου και τα στυλ πινάκων χωρίς να υλοποιήσει κενά κελιά

Η TXLSXNamedStyles.FindByName εντοπίζει μια εγγραφή ονομασμένου στυλ με το display name της χωρίς χειροκίνητη σάρωση της συλλογής

Και τα 60 built-in ονόματα table styles light, medium και dark επιλύονται σε πλήρη theme-based μορφές τμημάτων που μοιράζονται οι έξοδοι HTML, PDF, εικόνας, preview και viewer

Μετατροπή τύπων

Το TXLSXCell.ConvertFormulaToValue αντικαθιστά έναν τύπο με την αποθηκευμένη τιμή του και το TXLSXCells.ConvertFormulasToValues εφαρμόζει την ίδια λειτουργία στην αποθηκευμένη συλλογή κελιών

Επικύρωση εισαγωγής τύπων

Τα TXLSXWorkbook.FormulaEntryPolicy και TXLSXWorksheet.ValidateFormulaEntry εκθέτουν το κοινό συμβόλαιο εισαγωγής τύπων χωρίς μεταβολές, διακρίνουν κενό κείμενο, άγνωστες συναρτήσεις, άγνωστα ονόματα, αποτυχίες σύνταξης και άκυρους στόχους, και αναγνωρίζουν καταχωρημένες συναρτήσεις χρήστη χωρίς να τις καλέσουν· δείτε Πολιτική επικύρωσης εισαγωγής τύπων

Διαγνωστικά αποθήκευσης κελιών

Το TXLSXCells.PackedStorageEnabled ελέγχει το packed R backend που χρησιμοποιείται από συμβατές τυποποιημένες ομαδικές εγγραφές row-major, και το PackedCellCount αναφέρει τα κελιά που διατηρούνται εκεί πριν η πρόσβαση σε επίπεδο αντικειμένου υλοποιήσει σταθερά handles κελιών

Η GetStorageStatistics αναφέρει blocks γραμμών, κατοικημένες γραμμές, και byte μετρήσεις αντικειμένων, κειμένου, τύπων, rich-text, εκτιμώμενων packed, ενεργών packed, δεσμευμένων, χρησιμοποιούμενων και packed-string για μετρήσιμες αποφάσεις μνήμης· οι μετρήσεις style payloads και τα αποφευγμένα bytes styled-blank payloads εκθέτουν απευθείας το copy-on-write μοίρασμα

Λεπτομέρειες AutoFilter

Το 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 είναι τα αντίστοιχα προσκηνίου, διατηρώντας χρώματα προσκηνίου theme, palette-index και tint-and-shade δίπλα στην τιμή RGB

Γραφήματα

Το TXLSXChart εκθέτει τα PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly και το facade συμβατότητας 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 φρεσκάρει το προσπελάσιμο κείμενο του φύλλου μία φορά ανά γενιά βιβλίου εργασίας και διατηρεί εξωτερικά caches χωρίς να ανοίξει πηγή δεδομένων

Το TXLSXChartSeries.CategoriesMultiLevel εκπέμπει κατηγορίες c:multiLvlStrRef για ιεραρχικές ετικέτες αξόνων, ενώ η προεπιλογή κρατά την επίπεδη εκπομπή 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, με συγκρίσεις strings χωρίς διάκριση πεζών/κεφαλαίων, αριθμητικές και boolean

Η TXLSXSheets.AddCopy αντιγράφει ένα φύλλο εργασίας με εξαρτώμενα αντικείμενα και το ByPos προσπελαύνει τη συλλογή με την τρέχουσα θέση καρτέλας

Τα TXLSXExternalLink.AddDefinedName και DefinedNameCount διατηρούν αποθηκευμένα εξωτερικά ονόματα και η FindDefinedName εντοπίζει μία εγγραφή με το όνομά της· οι ιδιότητες μόνο για ανάγνωση RelationshipId, SourceSlot και LinkKind εκθέτουν το αναγνωριστικό σχέσης του part του εξωτερικού συνδέσμου, τη θέση [N] με βάση το 1 που χρησιμοποιούν οι εξωτερικοί τύποι, και την ταξινόμηση του συνδέσμου (workbook, DDE, OLE ή άγνωστο)· το TXLSXHyperlink.TargetFrame διατηρεί το πλαίσιο περιήγησης-στόχο

Το TXLSXDefinedName.UnknownAttributes διατηρεί μη αναγνωρισμένα attributes σε ένα ονομασμένο όνομα, ώστε οι μη υποστηριζόμενες επεκτάσεις να επιβιώνουν από round trips

Το TXLSXComment.AutoSizeFromText μεγεθύνει το σχήμα σχολίου σύμφωνα με το κείμενό του και το ClearFont αφαιρεί ρητές διαδρομές γραμματοσειράς rich-text

Το TXLSXImage.SvgData αποθηκεύει το συνοδευτικό SVG και το CameraRange προσδιορίζει μια περιοχή πηγής συνδεδεμένης εικόνας· το TXLSXTextBox.PrstToken διατηρεί το διακριτικό προκαθορισμένης γεωμετρίας DrawingML

Οι εικόνες μοιράζονται payloads χωρίς αντιγραφή bytes: η ανάθεση στο TXLSXImage.Blob (η διεπαφή IXLSXImageBlob με Data, SvgData, CacheKey, ContentDigest, SvgContentDigest και ByteSize) είναι η zero-copy διαδρομή για επαναλαμβανόμενες εικόνες αναφορών, τα digests υπολογίζονται μία φορά για media interning στην αποθήκευση, και τα μόνο για ανάγνωση TXLSXImage.CacheKey και ContentDigest αναφέρουν την ανατεθείσα ταυτότητα· η cache αναφορών απορρίπτει cache key που επαναχρησιμοποιείται με διαφορετικά bytes ή μορφές

Τα DrawingObjectCount και DrawingObject εκθέτουν μία σταθετή μικτή σειρά σε εικόνες, γραφήματα, text boxes, διατηρημένα raw anchors και ομάδες· κάθε TXLSXDrawingObject εκθέτει Kind, Parent, ChildCount και TextBox, και μπορεί να αναταξινομηθεί με BringToFront, SendToBack, BringForward και SendBackward

Η GroupDrawingObjects δημιουργεί μια ομάδα DrawingML με επίγνωση μετασχηματισμού από επιλεγμένα αντικείμενα και η UngroupDrawingObject επαναφέρει τα παιδιά της με τη σειρά τους, συμπεριλαμβανομένων ομάδων φορτωμένων από υπάρχον πακέτο

Κλασικά αντίστοιχα φύλλου εργασίας

Τα TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage και BackgroundImageResource συγγράφουν, αφαιρούν και επιθεωρούν φόντα φύλλου BIFF8· τα δεδομένα bitmap εκθέτονται ως standard BMP, οι εγγενείς ή άγνωστες μορφές διατηρούν το raw payload και τον κωδικό μορφής τους, και τα γνωστά φόντα μετατρέπονται προς τις δύο κατευθύνσεις μεταξύ των μηχανών Classic και XLSX

Το TXLSWorksheet.ConvertFormulasToValues αντικαθιστά τους τύπους με αποθηκευμένα αποτελέσματα, οι υπερφορτώσεις OpenRTF εισάγουν έναν πίνακα RTF στον προεπιλεγμένο ή σε στόχο που επιλέγει ο καλών, το WriteAutoValue επιλέγει τύπο κελιού από ένα variant και το DefaultFormat εκθέτει το προεπιλεγμένο XF του φύλλου εργασίας