Další členy knihovního API

Tato stránka doplňuje referenci veřejných typů, které podporují primární API sešitů, listů, vykreslování, importu, diagnostiky a prohlížeče, ale nevyžadují samostatného průvodce zaměřeného na konkrétní úlohu

Filtrování a podmíněné formátování

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec a TXLSDxfStyle přijímají AttachWriteGuardOwner, jenž propojí objekt pravidla s jeho vlastnícím sešitem, takže úpravy automaticky získají hlídač zápisu; vlastník implementuje TXLSCondFormatWriteGuardOwner, jehož jediná metoda AcquireWriteGuard předá pravidlu hlídač zápisu sešitu. TXLSDxfStyle přidává FontColorIndex s FontColorIsIndexed a dvojice FillFgColorIndex / FillFgColorIsIndexed a FillBgColorIndex / FillBgColorIsIndexed pro barvy pravidel jako index palety, a navíc přepisy diferenciálního písma FontName, FontSize a FontScheme (prázdný řetězec, velikost v bodech, nebo slot písma motivu jako major / minor) vedle stávajících členů pro tučné, kurzívu, podtržení a barvu; každé přiřazení získá hlídač zápisu a označí pravidlo jako dirty pro opětovné vygenerování

TXLSConnections, TXLSDataTables a TXLSQueryTables zpřístupňují OnAcquireWriteGuard (typy TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuard a TXLSQueryTableAcquireWriteGuard), háček, kterým jejich editační cesty před mutací získávají IXLSWorkbookWriteGuard vlastnícího sešitu a poté posouvají generaci sešitu; hlídač si zaznamenává StartGeneration a Complete označí zápis za dokončený, takže se mohou přestavět závislé mezipaměti

Zachovaná datová připojení nesou typovaný popis: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) klasifikuje připojení, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) zaznamenává jeho režim ověřování a každá hodnota parametru připojení je označena TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Datové tabulky what-if hlásí svůj uložený druh definice přes TXLSDataTableKind

Datové tabulky what-if a seskupování kontingenčních tabulek

Práhy sad ikon lze programově vykreslit nebo validovat: XLSCfIconSetCount hlásí, kolik ikon definuje TXLSIconSetType, a XLSBuildCfIconGeometry naplní TXLSCfIconGeometry primitivami (TXLSCfIconPrimitive, druh TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) a body (TXLSCfIconPoint), které jednu ikonu vykreslí, takže vlastní renderery odpovídají vestavěným tvarům ikon Excelu

Diagnostika, trasování vzorců a validace

Zásady ukládání externích odkazů

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Audit výpočtů a nápovědné vlastnosti sešitu

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;
      

Stav tabulkových vzorců a IME

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

Inspekce a odstranění podoken úloh doplňků webu

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

Politika zobrazování objektů sešitu

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;
      

Kalibrační hodnoty a snímky vykreslování

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;
      

Geometrie vykreslování a měření písma

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, generování kódu, porovnávání a monitorování

Pomocníci pro balíčky a binární úložiště

Rozšíření pro kreslení a prohlížeč sešitů

Stránkování, výstup obrázků a tisk

Modely grafů Classic a grafové objekty listu

Typovaný dekódovaný model grafu

Dekódovaný stav grafu je zpřístupněn jako prosté records a enumy, takže inspekční kód nikdy nemusí procházet surové záznamy BIFF: TXLSChartInfo nese souhrn dekódovaného grafu s TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), každá řada hlásí TXLSChartSeriesType a TXLSChart3DState spolu s TXLSChart3DInfo popisují trojrozměrná zobrazení. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) a TXLSChartLegendPosition klasifikují osy a legendy, model datové osy používá TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) a TXLSChartDateValues. TXLSCustomChart zpřístupňuje dekódovaný model přes TXLSChartInfo; anotace trendline a chybových úseček jsou typované objekty (TXLSChartTrendline, TXLSChartErrorBars) dosažitelné z každé řady

Záznamy pro tvorbu grafů

Tvorba grafových listů a builderů přijímá prosté records místo objektových grafů: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfo a TXLSChartSeriesStyleInfo naplní položky řad předávané do TXLSWorksheets.AddChartSheet a sdíleného builderu grafů a TXLSPivotChartInfo popisuje rámec kontingenčního grafu použitý, když se graf připojuje ke kontingenční tabulce

Přílohy PDF, podpisy a export HTML

Audit výpočtů a ovládací prvky sešitu

Kompatibilita zastaralého rámování PivotCache

StreamId se zapisuje jako záznam SXStreamID ([MS-XLS] §2.4.303) a opakuje se jako pole idstm v hlavičce SXDB, které se musí rovnat; SourceDataType se zapisuje jako záznam SXVS ([MS-XLS] §2.4.317: $0001 list, $0002 externí, $0004 konsolidace, $0010 scénář) a opakuje se jako pole vsType v hlavičce SXDB, které se musí rovnat. Mezipaměti postavené z oblasti listu začínají typem listu, zatímco mezipaměti načtené zpět ze souboru si ponechají hodnotu, kterou nesl jejich substream, takže zapisovač BIFF nikdy neuvádí v poli SXDB záznam, který nevyslal; RawHasStorageStream označuje mezipaměť načtenou z vlastního storage streamu, jejíž deskriptor na úrovni celého sešitu předchází kešovaným záznamům

Integrace schránky a možnosti vložení

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;
      

Řešení zobrazovaného textu buňky

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;
      

Objekty ověřování dat Classic

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 }
      

Skenování a řešení indexovaných barev

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

Pomocníci pro odkazy 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;
      

Viz také

• Další členy klasického XLS API
• Pokročilí členové API XLSX
• Řídká geometrie osnovy
• Trasování a audit vzorců
• Prohlížeč sešitů