Membri API suplimentari ai bibliotecii

Această pagină completează referința pentru tipurile publice care susțin API-urile principale de registru de lucru, foaie de lucru, randare, import, diagnosticare și vizualizator, dar nu necesită un ghid separat orientat pe sarcini

Filtrare și formatare condiționată

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec și TXLSDxfStyle acceptă AttachWriteGuardOwner, legând obiectul regulii de registrul de lucru care îl deține, astfel încât editările să obțină automat o gardă de scriere; deținătorul implementează TXLSCondFormatWriteGuardOwner, a cărui unică metodă AcquireWriteGuard înmânează regulii garda de scriere a registrului de lucru. TXLSDxfStyle adaugă FontColorIndex cu FontColorIsIndexed plus perechile FillFgColorIndex / FillFgColorIsIndexed și FillBgColorIndex / FillBgColorIsIndexed pentru culori de regulă cu index de paletă, plus suprascrierile de font diferențial FontName, FontSize și FontScheme (șir gol, o dimensiune în puncte sau un slot de font de temă precum major / minor) alături de membrii existenți bold, italic, underline și de culoare; fiecare atribuire obține garda de scriere și marchează regula ca dirty pentru re-emisie

TXLSConnections, TXLSDataTables și TXLSQueryTables expun OnAcquireWriteGuard (tipurile TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuard și TXLSQueryTableAcquireWriteGuard), hook-ul folosit de căile lor de editare pentru a obține IXLSWorkbookWriteGuard al registrului de lucru deținător înainte de modificare și pentru a avansa apoi generația registrului de lucru; garda înregistrează StartGeneration, iar Complete marchează scrierea ca terminată, astfel încât cache-urile dependente să se poată reconstrui

Conexiunile de date păstrate poartă o descriere tipizată: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) clasifică conexiunea, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) înregistrează modul său de autentificare, iar fiecare valoare de parametru a conexiunii este etichetată cu TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Tabelele de date what-if raportează tipul definiției lor stocate prin TXLSDataTableKind

Tabele de date what-if și grupare pivot

Pragurile seturilor de pictograme pot fi randate sau validate programatic: XLSCfIconSetCount raportează câte pictograme definește un TXLSIconSetType, iar XLSBuildCfIconGeometry umple un TXLSCfIconGeometry cu primitivele (TXLSCfIconPrimitive, tip TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) și punctele (TXLSCfIconPoint) care desenează o pictogramă, astfel încât randatoarele personalizate să corespundă formelor de pictograme incorporate în Excel

Diagnosticare, urmărirea formulelor și validare

Politici de salvare a legăturilor externe

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Audit de calcul și indicii pentru registrul de lucru

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;
      

Formule de tabel și stare IME

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

Inspecția și eliminarea panourilor de activități ale programelor de completare 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;
      

Politica de afișare a obiectelor registrului de lucru

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;
      

Valori de calibrare a randării și instantanee

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;
      

Geometria randării și măsurarea fonturilor

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;
      

Import, generare de cod, comparare și monitorizare

Asistenți pentru pachete și stocare binară

Adăugiri pentru desenare și vizualizatorul de registre de lucru

Paginare, ieșire de imagini și tipărire

Modele de diagrame clasice și obiecte diagramă în foaia de lucru

Model tipizat de decodare a diagramelor

Starea decodată a diagramei este expusă ca înregistrări și enumerări simple, astfel încât codul de inspecție nu trebuie să parcurgă înregistrări BIFF brute: TXLSChartInfo transportă rezumatul decodat al diagramei cu TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), fiecare serie raportează TXLSChartSeriesType, iar TXLSChart3DState plus TXLSChart3DInfo descriu vizualizările tridimensionale. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) și TXLSChartLegendPosition clasifică axele și legendele, iar modelul de axă de dată folosește TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) și TXLSChartDateValues. TXLSCustomChart expune modelul decodat prin TXLSChartInfo; adnotările de linii de tendință și bare de eroare sunt obiecte tipizate (TXLSChartTrendline, TXLSChartErrorBars), accesibile din fiecare serie

Înregistrări pentru crearea diagramelor

Crearea foilor de diagramă și a builder-ului acceptă înregistrări simple în loc de grafuri de obiecte: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfo și TXLSChartSeriesStyleInfo umplu intrările de serie transmise către TXLSWorksheets.AddChartSheet și builder-ul partajat de diagrame, iar TXLSPivotChartInfo descrie încadrarea diagramei pivot folosită când o diagramă este atașată unui tabel pivot

Atașamente PDF, semnături și export HTML

Audit de calcul și controale ale registrului de lucru

Compatibilitate cu framing-ul PivotCache de tip vechi

StreamId este scris ca înregistrarea SXStreamID ([MS-XLS] §2.4.303) și repetat ca câmpul idstm din antetul SXDB, care trebuie să-i fie egal; SourceDataType este scris ca înregistrarea SXVS ([MS-XLS] §2.4.317: $0001 foaie de lucru, $0002 extern, $0004 consolidare, $0010 scenariu) și repetat ca câmpul vsType din antetul SXDB, care trebuie să-i fie egal. Cache-urile construite dintr-un interval de foaie de lucru pornesc cu tipul foaie de lucru, în timp ce cache-urile citite înapoi dintr-un fișier păstrează valoarea transportată de subfluxul lor, astfel încât writer-ul BIFF nu lasă niciodată un câmp SXDB care numește o înregistrare pe care nu a emis-o; RawHasStorageStream marchează un cache încărcat din propriul său flux de stocare, al cărui descriptor global de registru precede înregistrările din cache

Integrarea clipboard-ului și opțiuni de lipire

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;
      

Rezolvarea textului de afișare al celulei

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;
      

Obiecte de validare a datelor Classic 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 }
      

Scanarea și rezolvarea culorilor indexate

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);
      

Asistenți pentru referințe 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;
      

Consultați și

• Membri API XLS clasic suplimentari
• Membri avansați ai API XLSX
• Geometrie de contur rară
• Trasarea și auditarea formulelor
• Vizualizator de registru de lucru