Ek kitaplık API üyeleri

Bu sayfa, birincil çalışma kitabı, çalışma sayfası, işleme, içe aktarma, tanılama ve görüntüleyici API'lerini destekleyen ancak ayrı bir göreve yönelik kılavuz gerektirmeyen genel türler için başvuruyu tamamlar

Filtreleme ve koşullu biçimlendirme

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpecve TXLSDxfStyle , kural nesnesini sahip çalışma kitabına bağlayan ve düzenlemelerin bir yazma koruyucusunu otomatik olarak edinmesini sağlayan AttachWriteGuardOwnerkabul eder; sahip, tek bir TXLSCondFormatWriteGuardOwneryöntemiyle kurala çalışma kitabının yazma koruyucusunu veren AcquireWriteGuard arayüzünü uygular. TXLSDxfStyle , palet indeksli kural renkleri için FontColorIndex ile birlikte FontColorIsIndexed ile FillFgColorIndex / FillFgColorIsIndexed ve FillBgColorIndex / FillBgColorIsIndexed çiftlerini; diferansiyel yazı tipi geçersiz kılmaları olan FontName, FontSizeve FontScheme 'i (boş dize, bir punto boyutu veya major / minorgibi bir tema yazı tipi yuvası) ise mevcut kalın, italik, altı çizili ve renk üyelerinin yanına ekler; her atama yazma koruyucusunu edinir ve kuralı yeniden yazım için kirli işaretler

TXLSConnections, TXLSDataTablesve TXLSQueryTables expose OnAcquireWriteGuard üyesini açığa çıkarır (türler TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuardve TXLSQueryTableAcquireWriteGuard); bu kanca, düzenleme yollarının değişiklik yapmadan önce sahip çalışma kitabının IXLSWorkbookWriteGuard nesnesini edinmesini ve ardından çalışma kitabı jenerasyonunu ilerletmesini sağlar; koruyucu StartGenerationdeğerini kaydeder, Complete ise yazmayı tamamlanmış olarak işaretleyerek bağımlı önbelleklerin yeniden derlenebilmesini sağlar

Korunan veri bağlantıları türlenmiş bir tanım taşır: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) bağlantıyı sınıflandırır, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) kimlik doğrulama modunu kaydeder ve her bağlantı parametresi değeri TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell) ile etiketlenir. What-if veri tabloları, saklanan tanım türlerini TXLSDataTableKind

What-if veri tabloları ve özet gruplama

Simge kümesi eşikleri programatik olarak çizilebilir ya da doğrulanabilir: XLSCfIconSetCount bir TXLSIconSetType değerinin kaç simge tanımladığını bildirir; XLSBuildCfIconGeometry ise tek bir simgeyi çizen ilkel öğeleri ( TXLSCfIconGeometry , türTXLSCfIconPrimitive: TXLSCfIconPrimitiveKind, cfipPolygon, cfipEllipse, cfipRect) ve noktaları ( cfipLine) birTXLSCfIconPointiçine doldurur; böylece özel işleyiciler Excel'in yerleşik simge şekilleriyle eşleşir

Tanılama, formül izleme ve doğrulama

İçe aktarma doğrulama şemaları

lxImportCheck ünitesindeki TXLSImportCheck, bir TXLSXWorksheet'i uygulamanın sahipliğindeki kurallara göre doğrular; saklanan skaler değerleri ve saklanan formül sonuçlarını inceler, 1 tabanlı çalışma sayfası koordinatları kullanır ve örtük metin-sayı, metin-tarih veya metin-Boolean dönüşümü yapmaz

Validator := TXLSImportCheck.Create;
try
  Validator.HeaderRow := 1;
  Rule := Validator.AddRule(2);
  Rule.Name := 'quantity';
  Rule.Flags := [irRequired, irValueType, irValueRange];
  Rule.ValueKind := ivkInteger;
  Rule.MinimumValue := 1;
  Rule.MaximumValue := 1000;

  Validator.AddUniqueRule([1, 3]).Name := 'account-and-region';
  Validator.AddCrossColumnRule(4, 5, icLessOrEqual).Name := 'start-before-end';
  FailureCount := Validator.Check(Sheet);
  if FailureCount > 0 then
    Validator.Annotate(Sheet, 'Import validator');
finally
  Validator.Free;
end;

HeaderRow > 0 denetimi bir sonraki satırda başlatır ve FirstRow'a öncelik alır; aksi hâlde FirstRow varsayılan 1'dir; LastRow = 0 çalışma sayfasının son kullanılan satırını kullanırken pozitif bir LastRow, hücreleri oluşturmadan yok olan hücreleri de kapsayabilir; sütunlar 1 ile 16.384 arasında, etkin veri satırı sınırları ise 1 ile 1.048.576 arasında olmalıdır

Sütun kuralları ve açık türler

AddRule(Column) o sütuna ait önceki kuralı değiştirip serbest bırakır; değer başına tür, aralık, uzunluk ve desen yüklemleri eksik değerleri, null'ları ve boş dizeleri atlar; irRequired ise bunları bildirir; benzersizlik, aşağıda açıklanan ayrı politikaları korur; boş olmayan whitespace bir değer olarak kalır; bir sayı Boolean sayılmaz, bir tarih sıradan bir sayı sayılmaz ve sayı görünüşlü bir dize metin olarak kalır

MinimumValue veya MaximumValue atamak o sınırı etkinleştirir; HasMinimum veya HasMaximum'dan herhangi biri onu yeniden devre dışı bırakabilir; her iki kapsayıcılık anahtarı da varsayılan True'dur; sınırlar sonlu türlü sayılar veya tarihler olmalıdır ve iki sınır karşılaştırılabilir olup boş olmayan bir aralık tanımlamalıdır; ters çevrilmiş, eksik, uyumsuz veya boş sınırlar, çalışma sayfası doğrulaması başlamadan hata fırlatır

Sayı sınırları sayısal değerleri, tarih sınırları tarihleri karşılaştırır; tam sayıdan tam sayıya karşılaştırmalar tüm Int64 ve UInt64 bitlerini korur; uyumsuz kategorideki değerler aralık denetimini geçemez; metin uzunluğu ve regex yüklemleri skalerin metin gösterimini incelemeye devam eder ve regex denetimleri mevcut IsMatch davranışını korur; bu nedenle metnin tamamı eşleşecekse ^...$ gibi çapalar kullanın; geçersiz bir regex, uyumluluk için kendi desen denetimini devre dışı bırakır

Tarih biçimli Excel değerleri

Excel'den içe aktarılan bir hücre, sayı biçimi tarih gösterse bile sayısal bir serial içerebilir; kabul edilen içe aktarma şeması buysa serial modunu açıkça seçin; mod yalnızca doğrulamayı etkiler ve saklanan hücre değerini asla değiştirmez

Rule := Validator.AddRule(4);
Rule.Flags := [irRequired, irValueType, irValueRange];
Rule.ValueKind := ivkDate;
if Sheet.Workbook.Date1904 then
  Rule.DateSerialMode := idsExcel1904
else
  Rule.DateSerialMode := idsExcel1900;
Rule.MinimumValue := VarFromDateTime(EncodeDate(2026, 1, 1));
Rule.MaximumValue := VarFromDateTime(EncodeDate(2026, 12, 31));

VarFromDateTime Variants içinde, EncodeDate ise SysUtils içinde tanımlıdır; sayısal serial'ler negatif olmalı ve 10.000 yılının 1 Ocak'ından önce çözülmelidir; kesirli serial'ler günün saatini korur; 1900 sistemi 60 dahil ile 61 hariç arasındaki her serial'i reddeder çünkü bu aralık kurgusal artık günü belirtir; 1904 sistemi ise serial sıfırı 1 Ocak 1904'e eşler

Tarih sınırları günün saatini içerir; dolayısıyla 31 Aralık gece yarısına ayarlanan bir üst sınır o günün sonraki saatlerini dışlar; son günün tamamının kabul edilmesi gerekiyorsa izleyen yılın 1 Ocak'ında kapsayıcı olmayan bir üst sınır kullanın; 10/08/2026 gibi metinsel tarihler, yapılandırılan serial modundan bağımsız olarak metin olarak kalır

Bileşik benzersizlik ve sütunlar arası karşılaştırmalar

Bileşik anahtarlar her üyenin tam Variant türünü ve metin kimliğini korur; Integer(1), Double(1), '1' dizesi, bir Boolean ve bir tarih ayrı üyelerdir; büyük/küçük harf katlama, Unicode normalleştirme, yerel ayar ayrıştırma veya ayırıcı belirsizliği yoktur; ('ab', 'c') ve ('a', 'bc') gibi kombinasyonlar farklı kalır; her doğrulama geçişi taze bir küme indeksi başlatır

SkipIncompleteRows = True olduğunda eksik, null veya boş dize üyesi o satırı küme benzersizliğinden dışlar; False yapmak bu üyeleri özgün Variant kimlikleriyle dahil eder; bir kopya, küme sütununu hücre adresi olarak bildirir ve ilk eşleşen satırı FirstDuplicateRow üzerinden bildirir

Mevcut tek sütunlu irUnique, metin tabanlı büyük/küçük harf duyarsız eşleştirme davranışını korur ve eksik veya null değerleri atlar; tek bir sütun için katı türlü kimlik gerekiyorsa AddUniqueRule([Column]) kullanın

Sütunlar arası karşılaştırmalar dizeleri sayılara, sayıları Boolean'lara veya sıradan sayıları tarihlere asla zorlamaz; uyumsuz karışık kategoriler icNotEqual için bile geçersiz kalır; dize karşılaştırmaları oluşmuş ve ayrışmış Unicode'u ayırır, gömülü null karakterleri korur ve daha kısa-önek-önce sıralamasını kullanır; SkipBlankValues = False olduğunda boş bir işlenen sütunlar arası ihlal üretir

Yapılandırılmış sonuçlar ve düzeltme çalışma kitapları

Check(Sheet) ihlal sayısını döndürür; ViolationCount artı 0 tabanlı Violation(Index) raporu numaralandırır; bir sütun kuralı ilk geçmeyen yüklemini bildirirken bağımsız yapılandırılmış küme ve karşılaştırma kuralları aynı hücre için ek ihlaller ekleyebilir; kararlı uygulama kural tanımlayıcıları gerekiyorsa anlamlı Name değerleri atayın

Formül hücreleri, saklanan önbellek değerleri kullanılarak doğrulanır; saklanan önbellek sonucu olmayan bir formül ivFormulaCacheMissing bildirir, hata sonucu ise ivCellError; taze formül sonuçları gerekiyorsa denetimden önce açıkça yeniden hesaplayın; doğrulama harici kaynaklara erişmez, formül tanımlarını değiştirmez veya önbelleğe alınmamış formülleri değerlendirmez

OnVerifyCell, TlxImportVerifyCell callback imzasını korur ve başarılı uygulanabilir sütun yüklemleri ile benzersizlik denetimlerinden sonra çalışır; Boolean döndürür ve uygulama hata iletisi ayarlayabilir; callback'ler çalışma kitabını ve doğrulama şemasını değişmez tutmalıdır ve çalışma kitabı yazımları okuma kirası tarafından reddedilir; callback istisnaları yayılır ve kira sonraki işlemler için serbest bırakılır

Check asla ek açıklama eklemez, satır silmez veya paketlenmiş değerleri somutlaştırmaz; denetimden sonra kırmızı yazı tipleri uygulamak ve mevcut açıklamalara hata metni eklemek için Annotate kullanın veya ihlal etmeyen satırları kaldırmak ve bir düzeltme çalışma kitabı oluşturmak için açıkça KeepOnlyViolations çağırın; bu yöntemler verilen çalışma sayfasını değiştirir, bu nedenle raporu inceledikten sonra amaçlanan çalışma kitabı üzerinde çağırın

Doğrulama, senkron çağrı için çalışma sayfasını ve çalışma kitabını ödünç alır; caller'ın nesne sahipliğini üstlenmez veya arayüz sahipliğinde bir çalışma kitabı gerektirmez; bir okuma kirası, denetim boyunca ilgili saklanan hücre anlık görüntülerini ve saklanan formül önbelleği erişimini korur

Dış bağlantı kaydetme ilkeleri

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Hesaplama denetimi ve çalışma kitabı ipuçları

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;
      

Tablo formülü ve IME durumu

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

Web Eklentisi görev bölmesi incelemesi ve kaldırma

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

Çalışma kitabı nesne görüntüleme ilkesi

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;
      

İşleme kalibrasyonu değerleri ve anlık görüntüler

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;
      

İşleme geometrisi ve yazı tipi ölçümü

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;
      

İçe aktarma, kod üretimi, karşılaştırma ve izleme

Çalışma kitabı karşılaştırması

lxCompare ünitesindeki TXLSXWorkbookCompare, iki TXLSXWorkbook örneğini formülleri yeniden hesaplamadan ve her iki çalışma kitabını da değiştirmeden karşılaştırır; sayfalar büyük/küçük harf duyarsız adla eşleştirilir ve yalnızca sayfa sırası değişikliği fark üretmez

Varsayılan Options değeri boştur ve her iki tolerans da varsayılan sıfırdır; varsayılan karşılaştırma eklenen veya kaldırılan sayfaları, eklenen veya kaldırılan saklanan hücreleri, değişen türlü literal değerleri, değişen formül metnini ve eklenen veya kaldırılan birleştirilmiş aralıkları bildirir

Literal karşılaştırma sayıları, metni, Boolean değerleri, tarihleri, hataları ve boşları ayırır: 1 sayısı '1' metninden farklıdır, bir Boolean kendi metin yazımından farklıdır, tarihler kendi türünü korur ve hatalar saklanan hata koduna göre karşılaştırılır; eşit değerli sayısal depolama türleri eşit karşılaştırılırken farklı Int64 değerleri kesin karşılaştırmada ayrı kalır

Options, TlxCompareOption kümesi olan TlxCompareOptions türündedir; bir seçeneği etkinleştirmek, farklarını varsayılan karşılaştırmaya ekler

SetFeatureLimits(MaxBytes, MaxItems) her iki ayarı değiştirmeden önce her iki pozitif sınırı doğrular; MaxFeatureBytes varsayılan 64 MiB, MaxFeatureItems ise varsayılan 1.000.000'dır ve tekil setter'lar aynı atomik doğrulamayı korur

Özellik bütçeleri, zengin metin bölümlerini, filtre XML düğümlerini, Pivot alanlarını, alan üyelerini ve kayıt değerlerini, slicer veya timeline bağlarını kapsayan her iki çalışma kitabından toplam ayrık kanonik baytları ve sayılan girdileri kapsar; okuyucular yerel XML kurmadan önce sayımları ve büyük metin girdilerini denetler, sınırlı çıktı akışlarını zorunlu tutar ve bir sınır aşıldığında EXLSXSemanticBudget fırlatır

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) her iki ayarı değiştirmeden önce her iki argümanı doğrular; her ikisi de sonlu ve negatif-olmayan olmalıdır ve tekil AbsoluteTolerance ile RelativeTolerance setter'ları aynı doğrulamayı kullanır

Sayısal literal ve sayısal önbellek değerleri, mutlak farkları AbsoluteTolerance'dan küçük-eşitse veya daha büyük mutlak değere göre farkları RelativeTolerance'dan küçük-eşitse eşit karşılaştırılır; sıfır eşiği kesin eşitliği korur, göreli hesap uç zıt değerlerde taşmayı önler ve tolerans metni zorlamaz veya tarih, stil, geometriye uygulanmaz

LeftName ve RightName, Report satırlarının kullandığı isteğe bağlı görüntü adlarını ayarlar ve varsayılan left ile right'tır; adlar yalnızca raporlamayı etkiler, sayfa eşleştirmesini veya karşılaştırmayı değil

Comparer := TXLSXWorkbookCompare.Create;
try
  Comparer.Options := [lcoFormulaCachedResults, lcoCellStyles,
    lcoAxisGeometry];
  Comparer.SetNumericTolerance(0.001, 0.000001);
  DifferenceCount := Comparer.Compare(LeftWorkbook, RightWorkbook);
  for I := 0 to DifferenceCount - 1 do
  begin
    Entry := Comparer.Diff(I);
    ReportLines.Add(Entry.Describe);
  end;
finally
  Comparer.Free;
end;

Compare fark sayısını döndürür, Count sonrasında bu sayıyı okur ve Diff(Index) 0 tabanlı indekslemeyle karşılaştırıcının sahipliğinde bir TlxCompareDiff döndürür; girdilerini okurken karşılaştırıcıyı tutun ve başka bir başarılı karşılaştırmadan sonra girdileri yeniden edinin

Her girdi Kind, Sheet, uygulanabilir olduğunda 1 tabanlı Row ve Col, Ref, LeftText, RightText ve türlü LeftKind / RightKind değerlerini sağlar; TlxCompareValueKind lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvError ve lcvFormula içerir; lcvNone yok olan taraf veya değer-olmayan fark için kullanılır

TlxCompareKind lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAdded ve lckMergeRemoved'i korur ve lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChanged ile lckColumnGeometryChanged ekler

Stil farkları LeftText ve RightText'te stabil kanonik stil parmak izleri taşır; geometri farkları karşılaştırılan boyutu, gizli, anahat ve daraltılmış durumunu taşır; Ref etkilenen bitişik eksen aralığını tanımlar; satırlarda Row ilk satırına ve Col sıfıra, sütunlarda Col ilk sütununa ve Row sıfıra ayarlanır

Özellik farkları lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged veya lckTimelineChanged kullanır; Change lccChanged, lccAdded veya lccRemoved'dır ve mevcut her taraf kanonik tanım parmak izini taşırken yok olan taraf boş dize taşır

lckRichTextChanged, hücre koordinatında değişen bölüm tanımını tanımlar ve LeftText ile RightText'te kanonik bölüm parmak izlerini taşır; sayısal tolerans hücre literallerine ve formül önbelleklerine uygulanırken türlü özellik tanımları kesin karşılaştırılır

Özellik referansları kapsamlı adları veya tablo adlarını tanımlar ya da doğrulama, koşullu biçim ve çizim tanımları için 1 tabanlı sıra konumlarını kullanır; sıralı bir özelliği eklemek veya taşımak birden çok konumu değiştirebilirken çalışma kitabı düzeyi ad girdileri boş Sheet taşır

lckBlankStyleRegionChanged, değişen boş dikdörtgeni Row, Col, kapsayıcı LastRow ve LastCol ile A1 Ref üzerinden tanımlar; saklanan koordinatlar sıradan hücre karşılaştırması ve lcoCellStyles tarafından işlenir; saklanan hücreleri ve boş alanları birlikte incelemek için her iki stil seçeneğini de etkinleştirin

Describe tek girdiyi biçimlendirir; Report(List) ise biçimlendirilmiş girdileri caller sahipliğinde bir TStrings'e ekler; türlü değer değişikliği türler farklı olduğunda tür etiketleri içerir ve sonuçlar hücre ekleme sırası yerine sayfa adı, satır, sütun, fark türü ve referansa göre sıralanır

Karşılaştırma okuma kiraları tutar, saklanan hücreleri ayrık imleç anlık görüntüleri üzerinden gezinir ve paketlenmiş depolamayı korur; geometri, saklanan meta veri sınırlarını ve kompakt tekrarlanan satır span'lerini bölümlendirirken boş stil karşılaştırması aktif dikdörtgen ve saklanan hücre sınırlarını dikdörtgen milyon satırlık bir ızgarayı taramadan süpürür; iş büyüklüğü saklanan özelliklere, bölge kesişimlerine ve bildirilen farklara bağlıdır

Başarısız bir karşılaştırma önceki başarılı sonucu korur; geçersiz tolerans ataması da mevcut ayarları ve sonucu korurken nil çalışma kitabı geçirmek sonucu temizler ve sıfır döndürür

Bu karşılaştırma, XLSX cephesinin saklanan hücre içeriğini ve seçili türlü özellik tanımlarını kapsar; ad, doğrulama, koşullu biçim, tablo ve grafik formül yazımı anlamsal formül ayrıştırıcısı üzerinden normalleştirilirken Pivot hesaplanmış formülleri saklanan tanım metnini korur

Tablo filtreleri desteklenen özel, değer listesi, tarih grubu, renk, simge, dinamik ve en-yüksek-sayı biçimlerini ve sıralama koşullarını kabul eder; bağımsız filtre sütunları ve değer kümesi girdileri sıralarını, Boolean varsayılanları ve sayısal yazımları normalleştirirken sıralama koşulu sırası önemli kalır

Türlü Pivot, slicer ve timeline karşılaştırması, kullanılabilirliği yenilemeden veya değerlendirmeden desteklenen yerel çalışma sayfası kaynaklarını ve OLAP-olmayan bağları çözer; yerel slicer kullanılabilirlik ipuçları türetilmiş görüntü meta verisidir, üye seçimleri ve tanınan yerel sıralama meta verisi ise karşılaştırılır

Opak yerel çizim özellikleri, eksik ikili Pivot modelleri, harici veya OLAP Pivot kaynakları, ham PivotTable ek kayıtları ve uzantı XML'i, bilinmeyen filtre XML'i ve modellenmemiş slicer veya timeline uzantı öznitelikleri ya da alt öğeleri EXLSSemanticSnapshot fırlatır; bu verilerin korunumu anlamsal eşdeğerlik ima etmez

Seçili içe aktarılmış PivotTable ve PivotCache özellikleri, türlü projeksiyonu karşılaştırmadan önce korunan yerel XML'i de doğrular; iç içe alan meta verisi ve önbellek kayıtları dahil; bilinmeyen ad alanları, öznitelikler, alt öğeler ve uzantı yükleri aynı iş birliği özellik sınırları içinde açıkça başarısız olurken modellenmiş slicer önbelleği bağları desteklenmiş kalır

TSimpleDomNode.RawName, okuyucu-normalleştirilmiş Name'in yanında özgün öğe QName'ini açığa çıkarır ve mevcut ayrıştırıcı ad eşleştirmesini değiştirmeden ad alanı duyarlı incelemeye izin verir

Çalışma kitabı ayarları ve opak paket meta verisi karşılaştırmanın dışında kalır; temel stil karşılaştırması koşullu biçim veya tablo stili görünümünü değerlendirmez ve çizim karşılaştırması anlamsal anlık görüntünün desteklenen resim, metin kutusu, grafik ve sıralı grup sınırlarını korur

Etkin zengin metin özellikleri

TMsoFbtOpt.StoredPids saklanan OfficeArt özellik tanımlayıcılarını sıralı olarak döndürür; TMsoFbtSp.PersistentFlags ise özellik veya çapa tahsis etmeden yerel şekil bayraklarını açığa çıkarır

TMsoShapeContainer.HasPreservedObjectData tutulan OBJ kuyruk baytlarını tanımlar; HasOrdinaryEmbeddedPictureObjectData resim kuyruklarının yalnızca tanınan pano-biçim ve sıfır resim bayrağı kayıtlarını içerip içermediğini denetler ve yükü kopyalamadan bağlantılı veya bilinmeyen kayıtları reddeder

TMSOShapeTextBox.HasValidTextRuns bölümler oluşturmadan saklanan TXO bölüm sınırlarını ve rezerve alanları denetler; TMsoDrawing.HasUnmodeledAppearance türlü ayrıştırıcının atladığı yerel çizim verisini tanımlar ve yakalamanın çözülmemiş görünümü açıkça reddetmesine izin verir

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSet ve ColorSet, false bayrakları, none, taban ve otomatik renkler dahil devralınan yazı tipi özelliklerini açık geçersiz kılmalarından ayırır; setter'lar, özelliğin değeri yeni bölümün başlangıç varsayılanına eşit olsa bile onu açık işaretler

TXLSXRichText.HasUnsupportedAppearance, türlü bölüm modelinin temsil edemeyeceği yerel zengin özellikleri bildirir; taşınabilir yakalama ve etkin zengin metin karşılaştırması bu tür bölümleri açıkça reddederken desteklenen paylaşılan/satır içi bölüm özellikleri ve whitespace içe aktarma semantiğini korur

Etkin zengin metin karşılaştırması, komşu eşit bölümleri birleştirmeden önce açık false geçersiz kılmaları uygular; devralınan ve açıkça temizlenmiş özellikler, paylaşılan dize tekilleştirmesi ve desteklenen XML gidiş dönüşleri boyunca ayrı kalır

TXMLReader.ResolveNamespaceUri(Prefix, Uri) okuyucu konumunu değiştirmeden güncel kapsam içi ad alanı bağını çözer ve bağ yoksa false döndürür; boş bir önek varsayılan ad alanını ister ve ham QName'ler ad alanı duyarlı inceleme için kullanılabilir kalır

Değişmez zengin/sahne kayıtları, yakalama-kaynak uzantısı ve HXRSNP02 aktarım sözleşmesi Taşınabilir başsız çıktı konusunda açıklanır

Ayrık stil ve eksen incelemesi

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) geçerli 1 tabanlı koordinatlar için ayrık bir TXLSSemanticCellStyle döndürür; saklanan ve paketlenmiş stilleri, çalışma sayfası varsayılanlarını, uygulanabilir stil kaplamalarını, örtük tarih biçimlerini, indeksli renkleri ve tema renklerini hücre somutlaştırmadan ve stil havuzlarını değiştirmeden çözer; genel çağrı bir okuma kirası edinir ve koşullu biçim ile tablo stili kurallarını dışlar

TXLSXWorksheet.GetStoredAxisSpans(IsRow) kapsayıcı 1 tabanlı FirstIndex ve LastIndex taşıyan TXLSXAxisSpan kayıtları dizisi olan TXLSXAxisSpans döndürür; boyut, gizli, anahat ve daraltılmış meta veri ayak izlerini bildirir, kompakt tekrarlanan satır yüksekliği span'lerini korur ve çalışma sayfasının etkin varsayılanını sıradan özellikleriyle kullanılabilir bırakır

Döndürülen span'ler ayrık normalleştirilmiş bir bölümleme değil saklanan meta veri ayak izlerini tanımlar; iki ekseni karşılaştıran uygulamalar ilk ve son sınırlarını birleştirip sonuçlanan her aralık için etkin durumu bir kez inceleyebilir

TXLSXWorksheet.GetStoredStyleRegions, kompakt sanal biçimlendirme ayak izleri için kapsayıcı FirstRow, FirstCol, LastRow ve LastCol sınırları içeren ayrık TXLSXStyleRegions döndürür; bu ayak izleri örtüşebilir ve caller'lar etkin görünümlerini ReadSemanticCellStyle ile okur

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) stabil bir Key, kanonik Definition baytları ve sayılan ItemCount taşıyan ayrık TXLSXSemanticFeatures girdileri döndürür; isteğe bağlı pozitif sınırlar varsayılan 64 MiB ve 1.000.000 girdidir

TXLSXSemanticFeatureKind xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelines ve xlsxSemanticTimelineCaches içerir

Tanımlı adlar ve üç önbellek türü çalışma kitabı geneli kapsam kullanır ve nil sayfaya izin verir; diğer türler çalışma kitabına ait bir çalışma sayfası gerektirir, kurallar ve çizimler saklanan sıralarını korur ve döndürülen diziler ile tamponlar caller sahipliğinde kopyalardır; bu okuyucular okuma kiraları edinir ve yukarıda açıklanan türlü kapsam ile açık desteklenmeyen veri davranışını devralır

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) 1 tabanlı koordinatlar için ayrık kanonik bölüm baytları döndürür; zengin metin yoksa ve IncludePlainText false ise boş tampon döndürür; isteğe bağlı ConsumedItems: PInteger yakalanan bölüm sayısını alır ve düz metin yakalama paketlenmiş depolamayı korur

TXLSPivotCacheField.GroupItemTypes[Index], GroupItemLabels[Index]'e karşılık gelen türlü türü açığa çıkarır ve saklanan gruplu etiket alanının dışındaki bir indeksi reddeder

Formül meta verisi ve Pivot sorgu callback'leri

TXLSGetCellFormulaText ve TXLSCalculator.OnGetCellFormulaText, 1 tabanlı SheetIndex ve 0 tabanlı Row/Col kullanarak saklanan ifade metnini okur, lxOk veya türlü bir hata kodu döndürür ve formül gizli korumasına uyar; TXLSGetPivotTable ve OnGetPivotTable, 1 tabanlı SheetIndex ve 0 tabanlı aralık koordinatlarıyla ödünç alınan bir tabloyu konumlandırır

Çalışma kitabı motorları bu isteğe bağlı callback'leri normal, salt okunur ve izole hesaplama bağlamlarında bağlar; callback'ler hedefleri yeniden hesaplamaz, Pivot kaynaklarını tazelemez veya sahipliği devretmez

TXLSPivotDataConstraint bir FieldName ve türlü Item saklar; TXLSPivotDataConstraints alan/öğe çiftlerini toplar; TXLSPivotTable.GetDataValue, ayrık bir yerel tablo/önbellek anlık görüntüsünden tek görünen desteklenen toplamı sorgular ve IntersectsQueryRange, modellenmiş rapor filtresi hücreleri dahil 1 tabanlı çalışma sayfası sınırlarını kullanır

TlxPivotQueryBudget iş ve bellek tahminlerini senkron alır ve değerlendirmenin devam edip edemeyeceğini döndürür; EXLSPivotQueryBudget ve EXLSPivotQueryUnsupported, tükelenen sınırları desteklenmeyen önbellek veya toplam modellerinden ayırır

TXLSPivotCache.QueryModelIsComplete, çözülmüş sorgu hazırliğini BIFF ham yeniden oynatım tamlığından bağımsız kaydeder; QueryRecordsValid içe aktarılan kayıt geçerliliğini açığa çıkarır ve SetQueryRecordValidity kayıtları yenilemeden biçim-okuyucu önceliğini uygular

Açık kod sayfası baytları

Döndürülen RawByteString'i doğrudan AddRawString'e veya bayt-yönelimli bir akış işlemine geçirin; onu varsayılan bir AnsiString'e dönüştürmek, yerel FPC sistemlerinde baytlarını yeniden kodlayabilir

Klasik tanımlı adlar ve dizi-formül blokları

Klasik yazı tipi, biçim ve stil havuzları

Paket ve ikili depolama yardımcıları

Çizim ve çalışma kitabı görüntüleyici ekleri

Sayfalandırma, görüntü çıktısı ve yazdırma

Klasik grafik modelleri ve çalışma sayfası grafik nesneleri

Türlenmiş grafik çözme modeli

Çözümlenen grafik durumu, sade kayıtlar ve enum'lar olarak açığa çıkarılır; böylece inceleme kodunun ham BIFF kayıtlarında gezinmesi gerekmez: TXLSChartInfo , TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble) ile birlikte çözümlenmiş grafik özetini taşır; her seri TXLSChartSeriesTypebildirir, TXLSChart3DState ve TXLSChart3DInfo ise üç boyutlu görünümleri tanımlar. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) ve TXLSChartLegendPosition eksenleri ve göstergeleri sınıflandırır; tarih ekseni modeli ise TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) ve TXLSChartDateValueskullanır. TXLSCustomChart , çözümlenen modeli TXLSChartInfoüzerinden açığa çıkarır; trend çizgisi ve hata çubuğu ek açıklamaları, her seriden ulaşılabilen türlenmiş nesnelerdir (TXLSChartTrendline, TXLSChartErrorBars)

Grafik oluşturma kayıtları

Grafik sayfası ve oluşturucu yazımı, nesne ağaçları yerine sade kayıtları kabul eder: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfove TXLSChartSeriesStyleInfo , TXLSWorksheets.AddChartSheet ve paylaşılan grafik oluşturucuya geçirilen seri girdilerini doldurur; TXLSPivotChartInfo ise bir grafik pivot tabloya bağlandığında kullanılan pivot grafik çerçevelemesini tanımlar

Klasik grafik dolgu incelemesi

TXLSCustomChart.GetChartModel, GelFrame kayıtlarında desteklenen yerel OfficeArt özellik tablolarını ve üçüncü özellik tablolarını — karmaşık yük girdilerini izleyen özellikler dahil — çözer; mevcut oluşturucu gösterimi desteklenmiş kalır ve bozuk tablo sınırları önceki türlü dolguyu değişmeden bırakıp desteklenmeyen kaydı bildirir

Grafik incelemesi, türlü durumu eklemeden önce eksiksiz saklanan metni ve ek açıklama yükünü doğrular: kırpılmış trend çizgisi adları veya veri etiketi ayırıcıları kayıt kimliklerini _UnsupportedSemanticRecordID üzerinden bildirir; nil veya eksik boyutlu SeriesText başlıkları ise o kaydı hem BIFF5 hem BIFF8 için desteklenmeyen olarak bildirir; yükünü aşan bildirilen bir seri-metin boyutu EReadError fırlatır, eksik modeli serbest bırakır ve saklanan grafik kayıtlarını değişmeden bırakır

İşaretçi getter'ı ve dolgu incelemesi ham grafik depolamasını korur; bildirilen görünüm yakalama yolu desteklenen çekirdek grafikleri ayrıca doğrularken doğrulanmamış zengin başlık veya şekil uzantısı sağlamaları desteklenmeyen kalır

Sınırlı saklanan grafik, dize ve yazı tipi okuyucuları

TXLSChartStoredBytes ayrık bir bayt dizisidir ve TXLSChartStoredRecord RecordId ile Data içerir; bu okuyucular çözülmüş bir grafik modeli oluşturmadan veya formülleri değerlendirmeden tutulan kaynak depolamasını inceler

Paylaşılan dize tablosu bakımı ve SST yayımı

lxStringTable ünitesindeki TXLSStringTable, klasik çalışma kitabının paylaşılan dizelerini destekler; aşağıdaki üyeler okuyucu tarafı kaydı, yuva bakımı ve gidiş dönüşlü kaydetmeler için ham SST yayımını kapsar

PDF ekleri, imzalar ve HTML dışa aktarma

Hesaplama denetimi ve çalışma kitabı denetimleri

Eski PivotCache çerçeveleme uyumluluğu

StreamId , SXStreamID kaydı olarak yazılır ([MS-XLS] §2.4.303) ve SXDB başlığındaki idstm alanı olarak yinelenir; bu alan ona eşit olmalıdır. SourceDataType , SXVS kaydı olarak yazılır ([MS-XLS] §2.4.317: $0001 çalışma sayfası, $0002 harici, $0004 konsolidasyon, $0010 senaryo) ve SXDB başlığındaki vsType alanı olarak yinelenir; bu alan da ona eşit olmalıdır. Bir çalışma sayfası aralığından oluşturulan önbellekler çalışma sayfası türüyle başlar; bir dosyadan geri okunan önbellekler ise alt akışlarının taşıdığı değeri korur, böylece BIFF yazıcısı asla yaymadığı bir kaydı adlandıran bir SXDB alanı bırakmaz. RawHasStorageStream , kendi depolama akışından yüklenen ve çalışma kitabı kapsamlı tanımlayıcısı önbellek kayıtlarından önce gelen önbelleği işaretler

Pano tümleştirmesi ve yapıştırma seçenekleri

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 XLSParseXmlSpreadsheet(const XmlText: WideString;
  Loader: TXLSCSVLoader): Boolean;
function XLSClipboardHasBiff8: Boolean;
function XLSGetClipboardBiff8: AnsiString;
function XLSReadClipboardPasteData(out Biff8: AnsiString;
  out Text: WideString): Boolean;
function XLSSetClipboardBiff8(const Biff8: AnsiString;
  const Text: WideString; const Html: AnsiString = ''): Boolean;
      

Hücre görüntü metni çözümlemesi

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;
      

Klasik veri doğrulama nesneleri

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 }
      

İndeksli renk taraması ve çözümlemesi

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 başvuru yardımcıları

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;
      

Ayrıca bkz.

• Ek klasik XLS API üyeleri
• Gelişmiş XLSX API üyeleri
• Seyrek anahat geometrisi
• Formül izleme ve denetimi
• Çalışma kitabı görüntüleyicisi