Πρόσθετα μέλη API της βιβλιοθήκης

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

Φιλτράρισμα και μορφοποίηση υπό όρους

Τα TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec και TXLSDxfStyle δέχονται το AttachWriteGuardOwner, συνδέοντας το αντικείμενο του κανόνα με το βιβλίο εργασίας που το κατέχει ώστε οι επεξεργασίες να αποκτούν αυτόματα έναν φρουρό εγγραφής· ο ιδιοκτήτης υλοποιεί το TXLSCondFormatWriteGuardOwner, της οποίας η μοναδική μέθοδος AcquireWriteGuard παραδίδει στον κανόνα τον φρουρό εγγραφής του βιβλίου εργασίας. Το TXLSDxfStyle προσθέτει τα FontColorIndex με FontColorIsIndexed μαζί με τα ζεύγη FillFgColorIndex / FillFgColorIsIndexed και FillBgColorIndex / FillBgColorIsIndexed για χρώματα κανόνων με ευρετήριο παλέτας, καθώς και τις παρακάμψεις differential-font FontName, FontSize και FontScheme (κενή συμβολοσειρά, μέγεθος σε point ή θέση γραμματοσειράς θέματος όπως major / minor) δίπλα στα υπάρχοντα μέλη bold, italic, underline και χρώματος· κάθε ανάθεση αποκτά τον φρουρό εγγραφής και επισημαίνει τον κανόνα ως dirty για επανέκδοση

Τα TXLSConnections, TXLSDataTables και TXLSQueryTables εκθέτουν το OnAcquireWriteGuard (τύποι TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuard και TXLSQueryTableAcquireWriteGuard), τον hook που χρησιμοποιούν οι διαδρομές επεξεργασίας τους για να αποκτήσουν το IXLSWorkbookWriteGuard του βιβλίου εργασίας που τα κατέχει πριν από την τροποποίηση και να προωθήσουν στη συνέχεια τη γενιά του βιβλίου εργασίας· ο φρουρός καταγράφει το StartGeneration και το Complete σηματοδοτεί την ολοκλήρωση της εγγραφής ώστε οι εξαρτώμενες cache να μπορούν να ξαναχτιστούν

Οι διατηρημένες συνδέσεις δεδομένων συνοδεύονται από τυποποιημένη περιγραφή: το TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) ταξινομεί τη σύνδεση, το TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) καταγράφει τη λειτουργία πιστοποίησής της και κάθε τιμή παραμέτρου σύνδεσης επισημαίνεται με TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Οι πίνακες δεδομένων what-if αναφέρουν το είδος του αποθηκευμένου ορισμού τους μέσω του TXLSDataTableKind

Πίνακες δεδομένων what-if και ομαδοποίηση pivot

Τα όρια των σετ εικονιδίων μπορούν να αποδοθούν ή να επικυρωθούν προγραμματιστικά: το XLSCfIconSetCount αναφέρει πόσα εικονίδια ορίζει ένας TXLSIconSetType και το XLSBuildCfIconGeometry γεμίζει ένα TXLSCfIconGeometry με τα primitive (TXLSCfIconPrimitive, είδος TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) και τα σημεία (TXLSCfIconPoint) που σχεδιάζουν ένα εικονίδιο, ώστε οι προσαρμοσμένοι renderers να ταιριάζουν με τα ενσωματωμένα σχήματα εικονιδίων του Excel

Διαγνωστικά, ιχνηλάτηση τύπων και επικύρωση

Πολιτικές αποθήκευσης εξωτερικών συνδέσμων

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

property IXLSWorkbook.SaveExternalLinkValues: Boolean;
property IXLSWorkbook.UpdateLinks: TXLSExternalLinkUpdateMode;
property TXLSXWorkbook.SaveExternalLinkValues: Boolean;
property TXLSXWorkbook.UpdateLinks: TXLSExternalLinkUpdateMode;
      

Έλεγχος υπολογισμών και υποδείξεις βιβλίου εργασίας

function TXLSWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.RunCalculationAudit(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.FormulaIsVolatile(Formula: WideString): Boolean;

function TXLSWorkbook.AuditOverlayHash(SheetIndex, Row, Col: Integer): Integer;
function TXLSWorkbook.AuditOverlayRead(SheetIndex, Row, Col: Integer; var Value: Variant): Boolean;
procedure TXLSWorkbook.AuditOverlayWrite(SheetIndex, Row, Col: Integer; const Value: Variant);
procedure TXLSWorkbook.AuditOverlayClear;

TXLSCalculationAuditIssueKind = (xlcaiCacheMismatch, xlcaiParseFailure,
  xlcaiMissingFunction, xlcaiMissingName, xlcaiUnsupportedArguments,
  xlcaiCircularReference, xlcaiExternalReferenceDenied,
  xlcaiExternalReferenceMissing, xlcaiDataTableSkipped, xlcaiCancelled,
  xlcaiInternalFailure);

TXLSCalculationAuditIssue = record
  Kind: TXLSCalculationAuditIssueKind;
  SheetIndex: Integer;
  SheetName: WideString;
  Row: Integer;
  Col: Integer;
  Formula: WideString;
  Symbol: WideString;
  Expected: Variant;
  Actual: Variant;
  ResultCode: Integer;
  Stack: WideString;
  ExternalTarget: WideString;
end;
TXLSCalculationAuditIssues = array of TXLSCalculationAuditIssue;

TXLSRecalcAuditProgress = procedure(ASender: TObject;
  ACurrent, ATotal: Integer; var ACancel: Boolean) of object;

property WorkbookCodeName: WideString;
property CalculationThreadMode: TXLSCalculationThreadMode;
property ForceFullCalculationState: TXLSOptionalBooleanState;
property RefreshAllOnLoadState: TXLSOptionalBooleanState;
      

Κατάσταση τύπων πίνακα και IME

property TXLSXTable.ColumnCalculatedFormulaArrayStates[Index: Integer]: TXLSTableFormulaArrayState;
property TXLSXTable.ColumnTotalsFormulaArrayStates[Index: Integer]: TXLSTableFormulaArrayState;
property TDataValidation.ImeMode: TXLSDataValidationImeMode;
property TXLSXDataValidation.ImeModeKind: TXLSDataValidationImeMode;
      

Επιθεώρηση και αφαίρεση πλαισίων εργασιών πρόσθετων web

function IXLSWorkbook.HasWebAddinTaskPanes: Boolean;
function IXLSWorkbook.WebAddinTaskPaneCount: Integer;
function IXLSWorkbook.RemoveWebAddinTaskPanes: Integer;
function TXLSXWorkbook.HasWebAddinTaskPanes: Boolean;
function TXLSXWorkbook.WebAddinTaskPaneCount: Integer;
function TXLSXWorkbook.RemoveWebAddinTaskPanes: Integer;
      

Πολιτική εμφάνισης αντικειμένων βιβλίου εργασίας

TXLSObjectDisplayMode = (xlsodmShowAll, xlsodmShowPlaceholders,
  xlsodmHideAll);

property IXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSXWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSPaginationModel.ExportObjectPlaceholders: Boolean;
property TXLSPDFExport.ExportObjectPlaceholders: Boolean;
property TXLSSvgExport.ExportObjectPlaceholders: Boolean;
property TXLSPageImageExporter.ExportObjectPlaceholders: Boolean;
property TXLSPrintDocument.ExportObjectPlaceholders: Boolean;
property TXLSXHtmlExportOptions.ExportObjectPlaceholders: Boolean;
      

Τιμές βαθμονόμησης απόδοσης και στιγμιότυπα

TXLSRenderCalibration = record
  WidthCorrection: Double;
  HeightCorrection: Double;
  LineSpacing: Double;
  CellMarginFactor: Double;
  ScreenScaling: Integer;
  MeasurementDpi: Integer;
end;

function XLSDefaultRenderCalibration: TXLSRenderCalibration;
function XLSValidateRenderCalibration(const AValue: TXLSRenderCalibration;
  out AInvalidField: TXLSRenderCalibrationField): Boolean;
      

Γεωμετρία απόδοσης και μέτρηση γραμματοσειράς

TXLSRenderGeometryBackend = (xlsrgbAutoFit, xlsrgbPagination, xlsrgbPdf,
  xlsrgbSvg, xlsrgbBitmap, xlsrgbPrintPreview, xlsrgbViewer, xlsrgbHtml);

TXLSRenderFont = record
  Name: WideString;
  Size: Double;
  Styles: TXLSRenderFontStyles;
  Charset: Byte;
end;

function CreateXLSRenderGeometry(
  const ACalibration: TXLSRenderCalibration;
  AWorkbookGeneration: UInt64;
  ABackend: TXLSRenderGeometryBackend;
  ACacheCapacity: Integer = 4096): IXLSRenderGeometry;

property TXLSHTMLExport.RenderGeometry: IXLSRenderGeometry;
property TXLSXHtmlExportSession.RenderGeometry: IXLSRenderGeometry;
      

Εισαγωγή, δημιουργία κώδικα, σύγκριση και παρακολούθηση

Βοηθητικά πακέτων και δυαδικής αποθήκευσης

Προσθήκες σχεδίασης και προβολέα βιβλίου εργασίας

Σελιδοποίηση, έξοδος εικόνων και εκτύπωση

Μοντέλα διαγραμμάτων κλασικού XLS και αντικείμενα διαγραμμάτων φύλλου εργασίας

Τυποποιημένο μοντέλο αποκωδικοποίησης διαγραμμάτων

Η αποκωδικοποιημένη κατάσταση του διαγράμματος εκτίθεται ως απλές εγγραφές και enums, ώστε ο κώδικας επιθεώρησης να μη χρειάζεται ποτέ να διατρέχει ακατέργαστες εγγραφές BIFF: το TXLSChartInfo μεταφέρει τη σύνοψη του αποκωδικοποιημένου διαγράμματος με TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), κάθε σειρά αναφέρει TXLSChartSeriesType και το TXLSChart3DState μαζί με το TXLSChart3DInfo περιγράφουν τρισδιάστατες προβολές. Το TXLSChartAxisType (catCategory, catValue, catSeries, catDate) και το TXLSChartLegendPosition ταξινομούν άξονες και υπομνήματα, ενώ το μοντέλο άξονα ημερομηνιών χρησιμοποιεί TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) και TXLSChartDateValues. Το TXLSCustomChart εκθέτει το αποκωδικοποιημένο μοντέλο μέσω TXLSChartInfo· οι επισημάνσεις γραμμών τάσης και μπαρών σφάλματος είναι τυποποιημένα αντικείμενα (TXLSChartTrendline, TXLSChartErrorBars) προσβάσιμα από κάθε σειρά

Εγγραφές δημιουργίας διαγραμμάτων

Η σύνθεση σε φύλλα διαγραμμάτων και μέσω builder δέχεται απλές εγγραφές αντί για γραφήματα αντικειμένων: τα TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfo και TXLSChartSeriesStyleInfo γεμίζουν τις εγγραφές σειρών που περνιούνται στο TXLSWorksheets.AddChartSheet και στον κοινό chart builder, και το TXLSPivotChartInfo περιγράφει την πλαισίωση pivot chart που χρησιμοποιείται όταν ένα διάγραμμα συνδέεται με pivot πίνακα

Συνημμένα PDF, υπογραφές και εξαγωγή HTML

Έλεγχος υπολογισμών και στοιχεία ελέγχου βιβλίου εργασίας

Συμβατότητα παλαιού τύπου πλαισίωσης PivotCache

Το StreamId γράφεται ως εγγραφή SXStreamID ([MS-XLS] §2.4.303) και επαναλαμβάνεται ως πεδίο idstm της επικεφαλίδας SXDB, το οποίο πρέπει να ταυτίζεται με αυτό· το SourceDataType γράφεται ως εγγραφή SXVS ([MS-XLS] §2.4.317: $0001 φύλλο εργασίας, $0002 εξωτερικό, $0004 ενοποίηση, $0010 σενάριο) και επαναλαμβάνεται ως πεδίο vsType της επικεφαλίδας SXDB, το οποίο πρέπει να ταυτίζεται με αυτό. Οι cache χτισμένες από εύρος φύλλου εργασίας ξεκινούν με τον τύπο φύλλου εργασίας, ενώ οι cache που ξαναδιαβάζονται από αρχείο κρατούν την τιμή που μετέφερε η υπο-ροή τους, ώστε ο writer BIFF να μην αφήνει ποτέ πεδίο SXDB που ονοματίζει εγγραφή που δεν εξέδωσε· το RawHasStorageStream επισημαίνει μια cache φορτωμένη από τη δική της ροή αποθήκευσης, της οποίας ο descriptor καθολικού βιβλίου εργασίας προηγείται των καταχωρημένων εγγραφών

Ενσωμάτωση προχείρου και επιλογές επικόλλησης

TXLSPasteOption = (xlpoValuesOnly, xlpoInsertRows, xlpoInsertCols);
TXLSPasteOptions = set of TXLSPasteOption;

function XLSGetClipboardText: WideString;
function XLSSetClipboardText(const Text: WideString): Boolean;
function XLSSetClipboardTextAndHtml(const Text: WideString;
  const Html: AnsiString): Boolean;
function XLSBuildHtmlClipboard(const Html: AnsiString): AnsiString;
function XLSEncodeClipboardField(const Text: WideString): WideString;
function XLSClipboardHasText: Boolean;
function XLSParseClipboardGrid(const ClipboardText: WideString;
  Loader: TXLSCSVLoader): Boolean;
function XLSClipboardHasXmlSpreadsheet: Boolean;
function XLSGetClipboardXmlSpreadsheet: WideString;
function XLSClipboardHasBiff8: Boolean;
      

Επίλυση κειμένου εμφάνισης κελιού

TXLSCellDisplayMode = (xcdmFormattedValue, xcdmFormulaText,
  xcdmSuppressedZero);

TXLSCellDisplayOptions = record
  ShowFormulas: Boolean;
  ShowZeros: Boolean;
  SheetProtected: Boolean;
  FormulaWidthFactor: Double;
  DateSerialZero: Double;
end;

TXLSCellDisplayInput = record
  HasFormula: Boolean;
  FormulaHidden: Boolean;
  IsNumericZero: Boolean;
  FormulaText: WideString;
  FormattedText: WideString;
end;

TXLSCellDisplayResult = record
  Mode: TXLSCellDisplayMode;
  Text: WideString;
  TreatAsText: Boolean;
  EffectiveWidthFactor: Double;
end;

function XLSDefaultCellDisplayOptions: TXLSCellDisplayOptions;
function XLSNormalizeFormulaDisplayText(const FormulaText: WideString): WideString;
function XLSResolveCellDisplay(const Options: TXLSCellDisplayOptions;
  const Input: TXLSCellDisplayInput): TXLSCellDisplayResult;
      

Αντικείμενα επικύρωσης δεδομένων κλασικού XLS

TXLSDataValidationType = (xlsDvAny, xlsDvWhole, xlsDvDecimal, xlsDvList,
  xlsDvDate, xlsDvTime, xlsDvTextLength, xlsDvCustom);
TXLSDvErrorStyle = (xlsDvErrStop, xlsDvErrWarning, xlsDvErrInformation);

TDVRange = class;             { one validation rule over one or more ranges }
TDVRangeList = class;         { the per-sheet rule collection }
TDataValidator = class;       { engine that checks edits against the rules }
      

Σάρωση και επίλυση ευρετηριασμένων χρωμάτων

TXLSIndexedColorKind = (xickPalette, xickAutomatic, xickSystem, xickInvalid);
TXLSSystemColorRole = (xscrNone, xscrWindowText, xscrWindowBackground,
  xscrChartText, xscrChartBackground, xscrChartNeutral, xscrToolTipText);

TXLSIndexedColorResolution = record
  Kind: TXLSIndexedColorKind;
  RawIndex: Int64;
  PaletteSlot: Integer;
  SystemColorRole: TXLSSystemColorRole;
  ARGB: LongWord;
  HasResolvedColor: Boolean;
end;

TXLSNearestIndexedColorMatch = record
  InputARGB: LongWord;
  ColorIndex: Integer;
  PaletteSlot: Integer;
  ARGB: LongWord;
  DistanceSquared: Double;
  ExactMatch: Boolean;
end;

TXLSIndexedColorUsageKind = (xicukFont, xicukFillForeground,
  xicukFillBackground, xicukGradient, xicukBorder, xicukConditionalFormat,
  xicukChart, xicukShape, xicukComment, xicukWorksheet, xicukOther);
      

Βοηθητικές συναρτήσεις αναφορών A1

function XLSA1CellRef(ARow, ACol: Integer): WideString;
function XLSTryParseA1CellRef(const ARef: WideString;
  out ARow, ACol: Integer): Boolean;
function XLSTryParseA1RangeRef(const ARef: WideString;
  out ARow1, ACol1, ARow2, ACol2: Integer): Boolean;
      

Δείτε επίσης

• Πρόσθετα μέλη κλασικού API XLS
• Προηγμένα μέλη API XLSX
• Αραιή γεωμετρία περιγράμματος
• Ιχνηλάτηση και έλεγχος τύπων
• Προβολέας βιβλίου εργασίας