Ďalšie členy knižničného API

Táto stránka dopĺňa referenciu verejných typov, ktoré podporujú primárne API zošitov, hárkov, vykresľovania, importu, diagnostiky a prehliadača, ale nevyžadujú samostatnú príručku zameranú na konkrétnu úlohu

Filtrovanie a podmienené formátovanie

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec a TXLSDxfStyle prijímajú AttachWriteGuardOwner, ktorý prepojí objekt pravidla s jeho vlastniacim zošitom, takže úpravy automaticky získajú hlídača zápisu; vlastník implementuje TXLSCondFormatWriteGuardOwner, ktorého jediná metóda AcquireWriteGuard odovzdá pravidlu hlídača zápisu zošita. TXLSDxfStyle pridáva FontColorIndex s FontColorIsIndexed a dvojice FillFgColorIndex / FillFgColorIsIndexed a FillBgColorIndex / FillBgColorIsIndexed pre farby pravidiel ako index palety, plus prepisy rozdielového písma FontName, FontSize a FontScheme (prázdny reťazec, veľkosť v bodoch alebo slot písma motívu, napríklad major / minor) vedľa existujúcich členov pre tučné, kurzívu, podčiarknutie a farbu; každé priradenie získa hlídača zápisu a označí pravidlo ako dirty, aby sa pri ďalšom zápise vyslalo znova

TXLSConnections, TXLSDataTables a TXLSQueryTables sprístupňujú OnAcquireWriteGuard (typ TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuard a TXLSQueryTableAcquireWriteGuard), háčik, ktorým ich editačné cesty pred mutáciou získavajú IXLSWorkbookWriteGuard vlastniaceho zošita a potom posúvajú generáciu zošita; hlídač si zaznamenáva StartGeneration a Complete označí zápis za dokončený, takže sa môžu prestavať závislé medzipamäte

Zachované dátové pripojenia nesú typovaný popis: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) klasifikuje pripojenie, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) zaznamenáva jeho režim overovania a každá hodnota parametra pripojenia je označená TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Údajové tabuľky what-if hlásia uložený druh definície cez TXLSDataTableKind

Údajové tabuľky what-if a zoskupovanie krížových tabuliek

Prahové hodnoty sád ikon možno vykresľovať alebo validovať programovo: XLSCfIconSetCount hlási, koľko ikon definuje TXLSIconSetType, a XLSBuildCfIconGeometry naplní TXLSCfIconGeometry primitívami (TXLSCfIconPrimitive, druh TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) a bodmi (TXLSCfIconPoint), ktoré vykreslia jednu ikonu, takže vlastné renderery zodpovedajú vstavaným tvarom ikon Excelu

Diagnostika, sledovanie vzorcov a validácia

Zásady ukladania externých odkazov

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Audit výpočtov a tipy zošita

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;
      

Vzorce tabuliek a stav IME

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

Kontrola a odstránenie tabiel úloh doplnkov 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;
      

Zásady zobrazovania objektov zošita

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 vykresľovania

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 vykresľovania a meranie 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, generovanie kódu, porovnávanie a monitorovanie

Pomocníci pre balíky a binárne úložiská

Rozšírenia pre kreslenie a prehliadač zošitov

Stránkovanie, obrazový výstup a tlač

Klasické modely grafov a grafické objekty hárkov

Typovaný dekódovaný model grafu

Dekódovaný stav grafu je sprístupnený ako obyčajné záznamy a enumy, takže kontrolný kód nikdy nemusí prechádzať surovými záznamami BIFF: TXLSChartInfo nesie dekódované zhrnutie grafu s TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), každá séria hlási TXLSChartSeriesType a TXLSChart3DState spolu s TXLSChart3DInfo popisujú trojrozmerné pohľady. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) a TXLSChartLegendPosition klasifikujú osi a legendy, zatiaľ čo model dátumovej osi používa TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) a TXLSChartDateValues. TXLSCustomChart sprístupňuje dekódovaný model cez TXLSChartInfo; anotácie trendových čiar a chybových pruhov sú typované objekty (TXLSChartTrendline, TXLSChartErrorBars) dosiahnuteľné z každej série

Záznamy na tvorbu grafov

Tvorba hárkov grafov a tvorba cez zostavovač prijímajú obyčajné záznamy namiesto grafov objektov: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfo a TXLSChartSeriesStyleInfo napĺňajú položky sérií odovzdávané do TXLSWorksheets.AddChartSheet a zdieľaného zostavovača grafov a TXLSPivotChartInfo popisuje rámovanie kontingenčného grafu použité, keď je graf pripojený ku kontingenčnej tabuľke

Prílohy PDF, podpisy a export HTML

Audit výpočtov a ovládacie prvky zošita

Kompatibilita rámovania starších PivotCache

StreamId sa zapisuje ako záznam SXStreamID ([MS-XLS] §2.4.303) a opakuje sa ako pole idstm hlavičky SXDB, ktoré sa mu musí rovnať; SourceDataType sa zapisuje ako záznam SXVS ([MS-XLS] §2.4.317: $0001 hárok, $0002 externý, $0004 konsolidácia, $0010 scenár) a opakuje sa ako pole vsType hlavičky SXDB, ktoré sa mu musí rovnať. Medzipamäte postavené z oblasti hárka začínajú pri type hárka, zatiaľ čo medzipamäte načítané späť zo súboru si ponechajú hodnotu, ktorú niesol ich substream, takže zapisovač BIFF nikdy nenechá pole SXDB pomenovávať záznam, ktorý nevyslal; RawHasStorageStream označuje medzipamäť načítanú z vlastného úložného streamu, ktorej globálny deskriptor zošita predchádza zaznamenaným záznamom

Integrácia so schránkou a možnosti prilepenia

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;
      

Riešenie zobrazovaného textu bunky

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 overovania údajov 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 }
      

Skenovanie a riešenie indexovaných farieb

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

Pozri tiež

• Ďalší členovia klasického XLS API
• Pokročilé členy API XLSX
• Riedka geometria osnovy
• Sledovanie a audit vzorcov
• Prehliadač zošitov