Dodatkowe elementy API biblioteki

Ta strona uzupełnia dokumentację typów publicznych, które wspierają główne interfejsy API skoroszytu, arkusza, renderowania, importu, diagnostyki i przeglądarki, ale nie wymagają osobnego przewodnika zadaniowego

Filtrowanie i formatowanie warunkowe

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpeci TXLSDxfStyle przyjmują AttachWriteGuardOwner, który wiąże obiekt reguły z posiadanym skoroszytem, tak aby edycje automatycznie nabywały strażnika zapisu; właściciel implementuje TXLSCondFormatWriteGuardOwner, którego jedyna metoda AcquireWriteGuard przekazuje regule strażnika zapisu skoroszytu. TXLSDxfStyle dodaje FontColorIndex z FontColorIsIndexed oraz pary FillFgColorIndex / FillFgColorIsIndexed i FillBgColorIndex / FillBgColorIsIndexed dla kolorów reguł w postaci indeksów palety, a także nadpisania czcionki różnicowej FontName, FontSizei FontScheme (pusty ciąg, rozmiar w punktach albo slot czcionki motywu, taki jak major / minor) obok istniejących członów pogrubienia, kursywy, podkreślenia i koloru; każde przypisanie nabywa strażnika zapisu i oznacza regułę jako zmodyfikowaną (dirty), gotową do ponownej emisji

TXLSConnections, TXLSDataTablesi TXLSQueryTables udostępniają OnAcquireWriteGuard (typy TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuardi TXLSQueryTableAcquireWriteGuard) — punkt zaczepienia, którego ich ścieżki edycji używają, aby uzyskać IXLSWorkbookWriteGuard posiadanego skoroszytu przed modyfikacją i zwiększyć generację skoroszytu po niej; strażnik zapisuje StartGeneration, a Complete oznacza zapis jako ukończony, dzięki czemu zależne pamięci podręczne mogą zostać przebudowane

Zachowane połączenia danych niosą typowany opis: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) klasyfikuje połączenie, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) zapisuje jego tryb uwierzytelniania, a każda wartość parametru połączenia jest oznaczana przez TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Tabele danych analizy „co jeśli" zgłaszają zapisany rodzaj definicji przez TXLSDataTableKind

Tabele danych analizy „co jeśli" i grupowanie tabel przestawnych

Progi zestawów ikon można renderować i walidować programowo: XLSCfIconSetCount zgłasza, ile ikon definiuje dany TXLSIconSetType , a XLSBuildCfIconGeometry wypełnia TXLSCfIconGeometry prymitywami (TXLSCfIconPrimitive, rodzaj TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) i punktami (TXLSCfIconPoint) rysującymi jedną ikonę, dzięki czemu własne renderery odwzorowują wbudowane kształty ikon Excela

Diagnostyka, śledzenie formuł i walidacja

Schematy walidacji importu

TXLSImportCheck z lxImportCheck waliduje TXLSXWorksheet względem reguł należących do aplikacji; bada zapisane wartości skalarne i zapisane wyniki formuł, we współrzędnych arkusza numerowanych od jedynki, bez domniemanej konwersji tekst-na-liczbę, tekst-na-datę albo tekst-na-wartość logiczną

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 zaczyna sprawdzanie od następnego wiersza i ma pierwszeństwo przed FirstRow; w przeciwnym razie FirstRow przyjmuje domyślnie 1; LastRow = 0 używa ostatniego używanego wiersza arkusza, podczas gdy dodatnie LastRow może obejmować nieobecne komórki bez ich tworzenia; kolumny muszą się mieścić w przedziale od 1 do 16 384, a aktywne granice wierszy danych w przedziale od 1 do 1 048 576

Reguły kolumn i typy jawne

AddRule(Column) zastępuje i zwalnia poprzednią regułę tej kolumny; predykaty per wartość — typu, zakresu, długości i wzorca — pomijają wartości brakujące, nulle i puste ciągi, podczas gdy irRequired je zgłasza; unikatowość zachowuje opisane niżej odrębne polityki; niepusty whitespace pozostaje wartością; liczba nie kwalifikuje się jako wartość logiczna, data nie kwalifikuje się jako zwykła liczba, a ciąg wyglądający jak liczba pozostaje tekstem

Przypisanie MinimumValue albo MaximumValue włącza daną granicę; dowolne z HasMinimum albo HasMaximum może ją znów wyłączyć; oba przełączniki inkluzywności domyślnie mają True; granice muszą być skończonymi typowanymi liczbami albo datami, a obie granice muszą być porównywalne i opisywać niepusty przedział; odwrócone, brakujące, niezgodne albo puste granice rzucają wyjątek, zanim walidacja arkusza się zacznie

Granice liczbowe porównują wartości liczbowe, a granice dat porównują daty; porównania całkowite z całkowitą zachowują wszystkie bity Int64 i UInt64; wartości niezgodnej kategorii nie przechodzą sprawdzania zakresu; predykaty długości tekstu i wyrażeń regularnych nadal badają tekstową reprezentację skalara, a kontrole regex zachowują dotychczasowe zachowanie IsMatch, więc użyj kotwic takich jak ^...$, gdy dopasowany musi być kompletny tekst; nieprawidłowe wyrażenie regularne wyłącza swoją kontrolę wzorca dla zachowania kompatybilności

Wartości Excela sformatowane jako daty

Komórka zaimportowana z Excela może zawierać numeryczną wartość seryjną, nawet gdy jej format liczbowy wyświetla datę; wybierz tryb seryjny jawnie, gdy taki jest akceptowany schemat importu; tryb wpływa wyłącznie na walidację i nigdy nie zmienia zapisanej wartości komórki

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 jest zadeklarowane w Variants, a EncodeDate w SysUtils; numeryczne wartości seryjne muszą być nieujemne i rozwiązywać się przed 1 stycznia 10000; ułamkowe wartości seryjne zachowują porę dnia; system 1900 odrzuca każdą wartość seryjną od 60 włącznie do 61 z wyłączeniem, bo ten przedział oznacza fikcyjny dzień przestępny; system 1904 mapuje wartość zero na 1 stycznia 1904

Granice dat obejmują porę dnia, więc maksimum ustawione na północ 31 grudnia wyklucza późniejsze czasy tego dnia; użyj wyłącznej granicy górnej na 1 stycznia następnego roku, gdy cały ostatni dzień musi być zaakceptowany; daty tekstowe, takie jak 10/08/2026, pozostają tekstem niezależnie od skonfigurowanego trybu seryjnego

Kompozytowa unikatowość i porównania między kolumnami

Klucze kompozytowe zachowują dokładny typ Variant i tożsamość tekstową każdego członka; Integer(1), Double(1), ciąg '1', wartość logiczna i data to odrębni członkowie; nie ma składania wielkości liter, normalizacji Unicode, parsowania ustawień regionalnych ani wieloznaczności separatorów; kombinacje takie jak ('ab', 'c') i ('a', 'bc') pozostają różne; każdy przebieg walidacji zaczyna świeży indeks krotek

Gdy SkipIncompleteRows = True, brakujący, null albo pusty członek tekstowy wyklucza dany wiersz z unikatowości krotek; ustawienie na False włącza tych członków z ich oryginalnymi tożsamościami Variant; duplikat zgłasza pierwszą kolumnę krotki jako swój adres komórki i pierwszy pasujący wiersz przez FirstDuplicateRow

Istniejąca jednokolumnowa reguła irUnique zachowuje swoje tekstowe dopasowanie bez rozróżniania wielkości liter i pomija wartości brakujące lub nulle; użyj AddUniqueRule([Column]), gdy dla jednej kolumny wymagana jest ścisła typowana tożsamość

Porównania między kolumnami nigdy nie koercują ciągów na liczby, liczb na wartości logiczne ani zwykłych liczb na daty; mieszane niezgodne kategorie zawodzą nawet dla icNotEqual; porównania ciągów rozróżniają Unicode złożony i rozłożony, zachowują osadzone znaki null i używają porządku krótszy-prefiks-pierwszy; gdy SkipBlankValues = False, dowolny pusty operand produkuje naruszenie międzykolumnowe

Ustrukturyzowane wyniki i skoroszyty poprawek

Check(Sheet) zwraca liczbę naruszeń, a ViolationCount plus indeksowane od zera Violation(Index) wyliczają raport; jedna reguła kolumny zgłasza swój pierwszy zawodzący predykat, a niezależnie skonfigurowane reguły krotek i porównań mogą dodać kolejne naruszenia dla tej samej komórki; przypisuj sensowne wartości Name, gdy wywołujący potrzebują stabilnych identyfikatorów reguł aplikacji

Komórki formuł są walidowane według zapisanych wartości z pamięci podręcznej; formuła bez zapisanego wyniku w pamięci podręcznej zgłasza ivFormulaCacheMissing, a wynik błędu zgłasza ivCellError; jawnie przelicz przed sprawdzaniem, gdy wymagane są świeże wyniki formuł; walidacja nie sięga do źródeł zewnętrznych, nie zmienia definicji formuł i nie wylicza formuł bez pamięci podręcznej

OnVerifyCell zachowuje sygnaturę callbacku TlxImportVerifyCell i uruchamia się po udanych, mających zastosowanie predykatach kolumn oraz kontrolach unikatowości; zwraca wartość logiczną i może ustawić komunikat błędu aplikacji; callbacki muszą utrzymywać skoroszyt i schemat walidacji bez zmian, a zapisy do skoroszytu odrzuca dzierżawa odczytu; wyjątki callbacków propagują się, a dzierżawa jest zwalniana dla kolejnych operacji

Check nigdy nie adnotuje, nie usuwa wierszy i nie materializuje spakowanych wartości; użyj Annotate po sprawdzeniu, aby nałożyć czerwoną czcionkę i dopisać tekst błędu do istniejących komentarzy, albo jawnie wywołaj KeepOnlyViolations, by usunąć wiersze bez naruszeń i utworzyć skoroszyt poprawek; te metody modyfikują podany arkusz, więc wywołuj je na zamierzonym skoroszycie po przejrzeniu raportu

Walidacja pożycza arkusz i skoroszyt na czas synchronicznego wywołania; nie przejmuje własności obiektów wywołującego ani nie wymaga skoroszytu będącego interfejsem; dzierżawa odczytu chroni istotne migawki zapisanych komórek i dostęp do zapisanych pamięci podręcznych formuł przez cały czas trwania sprawdzenia

Zasady zapisywania łączy zewnętrznych

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Audyt obliczeń i podpowiedzi skoroszytu

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;
      

Formuły tabel i stan IME

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

Inspekcja i usuwanie okienek zadań dodatków internetowych

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

Polityka wyświetlania obiektów skoroszytu

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;
      

Wartości kalibracji renderowania i migawki

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 renderowania i pomiar czcionek

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, generowanie kodu, porównywanie i monitorowanie

Porównywanie skoroszytów

TXLSXWorkbookCompare w lxCompare porównuje dwie instancje TXLSXWorkbook bez przeliczania formuł i bez modyfikowania którejkolwiek ze stron; arkusze są parowane według nazwy bez rozróżniania wielkości liter, a sama zmiana kolejności arkuszy nie produkuje różnicy

Domyślna wartość Options jest pusta, a obie tolerancje domyślnie mają zero; porównanie domyślne zgłasza dodane lub usunięte arkusze, dodane lub usunięte zapisane komórki, zmienione typowane wartości literalne, zmieniony tekst formuł oraz dodane lub usunięte scalone zakresy

Porównanie literalne rozróżnia liczby, tekst, wartości logiczne, daty, błędy i puste: liczba 1 różni się od tekstu '1', wartość logiczna różni się od swojego zapisu tekstowego, daty zachowują własny typ, a błędy porównują się według zapisanego kodu błędu; numeryczne typy magazynowe o równych wartościach porównują się równo, a odrębne wartości Int64 pozostają odrębne w porównaniu dokładnym

Options ma typ TlxCompareOptions, zbiór TlxCompareOption; włączenie opcji dodaje jej różnice do porównania domyślnego

SetFeatureLimits(MaxBytes, MaxItems) waliduje obie dodatnie limity przed zmianą któregokolwiek ustawienia; MaxFeatureBytes domyślnie ma 64 MiB, a MaxFeatureItems domyślnie 1 000 000, a pojedyncze settery zachowują tę samą atomową walidację

Budżety funkcji obejmują zagregowane odłączone kanoniczne bajty i zliczone wpisy z obu skoroszytów, włącznie z blokami rich-text, węzłami XML filtrów, polami tabel przestawnych, członkami domen i wartościami rekordów oraz połączeniami slicerów lub osi czasu; czytniki sprawdzają zliczenia i duże wejścia tekstowe przed budową natywnego XML, egzekwują ograniczone strumienie wyjścia i rzucają EXLSXSemanticBudget, gdy limit zostanie przekroczony

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) waliduje oba argumenty przed zmianą któregokolwiek ustawienia; oba muszą być skończone i nieujemne, a pojedyncze settery AbsoluteTolerancei RelativeTolerance używają tej samej walidacji

Literały numeryczne i numeryczne wartości pamięci podręcznej porównują się równo, gdy ich różnica bezwzględna wynosi co najwyżej AbsoluteTolerance albo ich różnica względem większej wartości bezwzględnej wynosi co najwyżej RelativeTolerance; próg zero zachowuje równość dokładną, obliczenie względne unika przepełnienia dla skrajnych wartości przeciwnych, a tolerancja nie koercuje tekstu i nie stosuje się do dat, stylów ani geometrii

LeftNamei RightName ustawiają opcjonalne nazwy wyświetlane używane przez linie Report, domyślnie lefti right; nazwy wpływają wyłącznie na raportowanie, nie na parowanie arkuszy ani porównanie

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 zwraca liczbę różnic, Count odczytuje ją po fakcie, a Diff(Index) używa indeksowania od zera, by zwrócić należący do comparera TlxCompareDiff; zachowaj comparera podczas odczytu jego wpisów i nabyj wpisy ponownie po kolejnym udanym porównaniu

Każdy wpis dostarcza Kind, Sheet, jedno-bazowe Rowi Col tam, gdzie mają zastosowanie, Ref, LeftText, RightText oraz typowane wartości LeftKind / RightKind; TlxCompareValueKind zawiera lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvErrori lcvFormula, przy czym lcvNone jest używane dla nieobecnej strony albo różnicy niebędącej wartością

TlxCompareKind zachowuje lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAddedi lckMergeRemoved, a dodaje lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChangedi lckColumnGeometryChanged

Różnice stylów niosą stabilne kanoniczne odciski stylów w LeftTexti RightText; różnice geometrii niosą porównywany rozmiar, ukrycie, konspekt i stan zwinięcia, przy czym Ref identyfikuje dotknięty ciągły przedział osi, Row jest ustawiane na jego pierwszy wiersz, a Col na zero dla wierszy, albo Col na pierwszą kolumnę, a Row na zero dla kolumn

Różnice funkcji używają lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged albo lckTimelineChanged; Change to lccChanged, lccAdded albo lccRemoved, a każda obecna strona niesie kanoniczny odcisk swojej definicji, podczas gdy nieobecna strona niesie pusty ciąg

lckRichTextChanged identyfikuje zmienioną definicję bloku na współrzędnych komórki i niesie kanoniczne odciski bloków w LeftTexti RightText; tolerancja numeryczna stosuje się do literałów komórek i pamięci podręcznych formuł, podczas gdy typowane definicje funkcji porównują się dokładnie

Odniesienia funkcji identyfikują nazwy z zasięgiem albo nazwy tabel, albo używają jedno-bazowych pozycji sekwencji dla definicji walidacji, formatowania warunkowego i rysunków; wstawienie albo przeniesienie uporządkowanej funkcji może zmienić kilka pozycji, a wpisy nazw poziomu skoroszytu mają pusty Sheet

lckBlankStyleRegionChanged identyfikuje zmieniony pusty prostokąt przez Row, Col, inkluzywne LastRowi LastCol oraz jego odwołanie A1 Ref; zapisane współrzędne obsługuje zwykłe porównanie komórek i lcoCellStyles, więc włącz obie opcje stylów, by przeglądać zapisane komórki i puste obszary razem

Describe formatuje jeden wpis, a Report(List) dopisuje sformatowane wpisy do należącego do wywołującego TStrings; typowana zmiana wartości zawiera etykiety typów, gdy typy się różnią, a wyniki sortują się według nazwy arkusza, wiersza, kolumny, rodzaju różnicy i odwołania, a nie porządku wstawiania komórek

Porównanie trzyma dzierżawy odczytu, przechodzi przez zapisane komórki z odłączonymi migawkami kursorów i zachowuje magazyn spakowany; geometria partycjonuje zapisane granice metadanych i zwarte rozpiętości powtarzanych wierszy, podczas gdy porównanie pustych stylów zamiata granice aktywnego prostokąta i zapisanych komórek bez skanowania prostokątnej milionowej siatki wierszy; praca rośnie z liczbą zapisanych funkcji, przecięć regionów i zgłoszonych różnic

Nieudane porównanie zachowuje poprzedni udany wynik; nieprawidłowe przypisanie tolerancji także zachowuje istniejące ustawienia i wynik, a przekazanie skoroszytu nil czyści wynik i zwraca zero

To porównanie pokrywa zapisaną zawartość komórek fasady XLSX i wybrane typowane definicje funkcji; pisownia formuł nazw, walidacji, formatowania warunkowego, tabel i wykresów normalizuje się przez semantyczny parser formuł, natomiast obliczeniowe formuły tabel przestawnych zachowują swój zapisany tekst definicji

Filtry tabel przyjmują obsługiwane postacie własne, listy wartości, grup dat, kolory, ikony, dynamiczne i top-count oraz warunki sortowania; niezależne kolumny filtrów i wpisy zbiorów wartości normalizują swój porządek, domyślne wartości logiczne i zapisy numeryczne się normalizują, a porządek warunków sortowania pozostaje istotny

Typowane porównanie tabel przestawnych, slicerów i osi czasu rozwiązuje obsługiwane lokalne źródła arkuszy i powiązania bez OLAP, bez odświeżania i bez wyliczania dostępności; natywne podpowiedzi dostępności slicerów to pochodne metadane wyświetlania, podczas gdy zaznaczenia członków i rozpoznane natywne metadane sortowania są porównywane

Nieprzejrzyste natywne właściwości rysunków, niekompletne binarne modele tabel przestawnych, zewnętrzne albo OLAP źródła tabel przestawnych, surowe rekordy uzupełnień tabeli przestawnej i XML rozszerzeń, nieznany XML filtrów oraz niemodelowane atrybuty albo dzieci rozszerzeń slicerów lub osi czasu rzucają EXLSSemanticSnapshot; zachowanie takich danych nie oznacza równoważności semantycznej

Wybrane zaimportowane funkcje tabel przestawnych i PivotCache walidują też zachowany natywny XML przed porównaniem projekcji typowanej, włącznie z zagnieżdżonymi metadanymi pól i rekordami pamięci podręcznej; nieznane przestrzenie nazw, atrybuty, dzieci i ładunki rozszerzeń zawodzą jawnie w ramach tych samych kooperatywnych limitów funkcji, podczas gdy modelowane powiązania pamięci podręcznej slicerów pozostają obsługiwane

TSimpleDomNode.RawName ujawnia oryginalny QName elementu obok znormalizowanego przez czytnik Name, pozwalając na inspekcję wrażliwą na przestrzenie nazw bez zmieniania istniejącego dopasowywania nazw parsera

Ustawienia skoroszytu i nieprzejrzyste metadane pakietu pozostają poza porównaniem; porównanie stylów bazowych nie wylicza wyglądu formatowania warunkowego ani stylów tabel, a porównanie rysunków zachowuje obsługiwane przez migawkę semantyczną granice obrazów, pól tekstowych, wykresów i uporządkowanych grup

Efektywne właściwości tekstu sformatowanego

TMsoFbtOpt.StoredPids zwraca zapisane identyfikatory właściwości OfficeArt w porządku posortowanym, a TMsoFbtSp.PersistentFlags ujawnia natywne flagi kształtu bez alokowania właściwości ani zakotwiczeń

TMsoShapeContainer.HasPreservedObjectData identyfikuje zachowane końcowe bajty OBJ; HasOrdinaryEmbeddedPictureObjectData sprawdza, czy końcówki obrazów zawierają wyłącznie rozpoznane rekordy formatów schowka i zerowe flagi obrazu, i odrzuca rekordy połączone albo nieznane bez kopiowania ładunku

TMSOShapeTextBox.HasValidTextRuns sprawdza zapisane granice bloków TXO i pola zarezerwowane bez tworzenia bloków; TMsoDrawing.HasUnmodeledAppearance identyfikuje natywne dane rysunków pominięte przez parser typowany, pozwalając przechwyceniu jawnie odrzucić nierozwiązany wygląd

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSeti ColorSet odróżniają odziedziczone właściwości czcionki od jawnych nadpisań, włącznie z flagami false, none, baseline i kolorami automatic; settery oznaczają właściwość jako jawną, nawet gdy jej wartość równa się początkowemu domyślnemu nowego bloku

TXLSXRichText.HasUnsupportedAppearance zgłasza natywne właściwości sformatowane, których model typowanego bloku nie potrafi przedstawić; przenośne przechwytywanie i efektywne porównanie rich-text odrzucają takie bloki jawnie, podczas gdy obsługiwane właściwości bloków współdzielonych/inline i whitespace zachowują zaimportowaną semantykę

Efektywne porównanie rich-text stosuje jawne nadpisania false przed scalaniem sąsiednich równych bloków; właściwości odziedziczone i jawnie wyzerowane pozostają odrębne podczas deduplikacji współdzielonych ciągów i obsługiwanych round-tripów XML

TXMLReader.ResolveNamespaceUri(Prefix, Uri) rozwiązuje bieżące wiązanie przestrzeni nazw w zasięgu bez zmieniania pozycji czytnika, zwracając false, gdy wiązanie nie istnieje; pusty prefiks żąda domyślnej przestrzeni nazw, a surowe QName pozostają dostępne dla inspekcji wrażliwej na przestrzenie nazw

Niemutowalne rekordy rich/scene, rozszerzenie źródła przechwytywania i kontrakt transferu HXRSNP02 są opisane w przenośnym wyjściu bezgłowym

Odłączona inspekcja stylów i osi

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) zwraca odłączony TXLSSemanticCellStyle dla poprawnych współrzędnych od jedynki, rozwiązując zapisane i spakowane style, domyślne wartości arkusza, mające zastosowanie nakładki stylów, dorozumiane formaty dat, kolory indeksowane i kolory motywu, bez materializowania komórek i bez zmieniania pul stylów; publiczne wywołanie nabywa dzierżawę odczytu i wyklucza reguły formatowania warunkowego oraz style tabel

TXLSXWorksheet.GetStoredAxisSpans(IsRow) zwraca TXLSXAxisSpans, tablicę rekordów TXLSXAxisSpan z inkluzywnymi FirstIndexi LastIndex od jedynki; zgłasza ślady metadanych rozmiaru, ukrycia, konspektu i zwinięcia, zachowuje zwarte rozpiętości powtarzanych wysokości wierszy i pozostawia efektywny domyślny stan arkusza dostępny przez jego zwykłe właściwości

Zwrócone rozpiętości opisują zapisane ślady metadanych, a nie rozłączną znormalizowaną partycję; aplikacje porównujące dwie osie mogą połączyć swoje granice pierwsze i ostatnie, a potem zbadać efektywny stan raz na powstały przedział

TXLSXWorksheet.GetStoredStyleRegions zwraca odłączone TXLSXStyleRegions zawierające inkluzywne granice FirstRow, FirstCol, LastRowi LastCol dla zwartych śladów wirtualnego formatowania; te ślady mogą się nakładać, a wywołujący odczytują efektywny wygląd przez ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) zwraca odłączone wpisy TXLSXSemanticFeatures ze stabilnym Key, kanonicznymi bajtami Definition i zliczonym ItemCount; opcjonalne dodatnie limity domyślnie mają 64 MiB i 1 000 000 wpisów

TXLSXSemanticFeatureKind zawiera xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelinesi xlsxSemanticTimelineCaches

Nazwy zdefiniowane i trzy rodzaje pamięci podręcznych używają zasięgu całego skoroszytu i dopuszczają arkusz nil; pozostałe rodzaje wymagają arkusza należącego do skoroszytu, reguły i rysunki zachowują swoją zapisaną sekwencję, a zwracane tablice i bufory są kopiami należącymi do wywołującego; te czytniki nabywają dzierżawy odczytu i dziedziczą opisane wyżej typowane pokrycie oraz jawne zachowanie wobec danych nieobsługiwanych

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) zwraca odłączone kanoniczne bajty bloków dla współrzędnych od jedynki albo pusty bufor, gdy tekst sformatowany nie istnieje, a IncludePlainText jest false; opcjonalny ConsumedItems: PInteger otrzymuje liczbę przechwyconych bloków, a przechwytywanie zwykłego tekstu zachowuje magazyn spakowany

TXLSPivotCacheField.GroupItemTypes[Index] ujawnia typowany rodzaj odpowiadający GroupItemLabels[Index] i odrzuca indeks poza zapisaną domeną pogrupowanych etykiet

Metadane formuł i callbacki zapytań tabel przestawnych

TXLSGetCellFormulaTexti TXLSCalculator.OnGetCellFormulaText odczytują zapisany tekst wyrażenia przy jedno-bazowym SheetIndex i zero-bazowych Row/Col, zwracając lxOk albo typowany kod błędu i respektując ochronę ukrycia formuł; TXLSGetPivotTablei OnGetPivotTable lokalizują pożyczoną tabelę przy jedno-bazowym SheetIndex i zero-bazowych współrzędnych zakresu

Silniki skoroszytów podłączają te opcjonalne callbacki w kontekstach obliczeń zwykłych, tylko do odczytu i izolowanych; callbacki nie przeliczają celów, nie odświeżają źródeł tabel przestawnych i nie przenoszą własności

TXLSPivotDataConstraint przechowuje FieldNamei typowany Item, a TXLSPivotDataConstraints zbiera pary pole/element; TXLSPivotTable.GetDataValue odpytuje jeden widoczny obsługiwany agregat z odłączonej migawki lokalnej tabeli/pamięci podręcznej, a IntersectsQueryRange używa jedno-bazowych granic arkusza, włącznie z modelowanymi komórkami filtru raportu

TlxPivotQueryBudget synchronicznie otrzymuje szacunki pracy i pamięci oraz zwraca, czy wyliczanie może trwać dalej; EXLSPivotQueryBudgeti EXLSPivotQueryUnsupported rozróżniają wyczerpane limity od nieobsługiwanych modeli pamięci podręcznej albo agregatu

TXLSPivotCache.QueryModelIsComplete zapisuje gotowość zdekodowanego zapytania niezależnie od kompletności surowego replayu BIFF; QueryRecordsValid ujawnia ważność zaimportowanych rekordów, a SetQueryRecordValidity stosuje pierwszeństwo czytnika formatu bez odświeżania rekordów

Jawne bajty stron kodowych

Przekaż zwrócony RawByteString bezpośrednio do AddRawString albo zorientowanej bajtowo operacji strumienia; przekonwertowanie go na domyślny AnsiString może przekodować jego bajty na natywnych systemach FPC

Klasyczne nazwy zdefiniowane i bloki formuł tablicowych

Klasyczne pule czcionek, formatów i stylów

Pomocnicze funkcje pakietu i magazynu binarnego

Dodatki do rysowania i przeglądarki skoroszytów

Paginacja, wyjście obrazowe i drukowanie

Modele wykresów klasycznych i obiekty wykresów arkusza

Typowany model dekodowania wykresów

Zdekodowany stan wykresu jest udostępniany jako zwykłe rekordy i typy wyliczeniowe, więc kod inspekcji nigdy nie musi przechodzić przez surowe rekordy BIFF: TXLSChartInfo niesie zdekodowane podsumowanie wykresu z TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), każda seria zgłasza TXLSChartSeriesType, a TXLSChart3DState wraz z TXLSChart3DInfo opisują widoki trójwymiarowe. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) i TXLSChartLegendPosition klasyfikują osie i legendy, a model osi dat używa TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) i TXLSChartDateValues. TXLSCustomChart udostępnia zdekodowany model przez TXLSChartInfo; adnotacje linii trendu i słupków błędów są typowanymi obiektami (TXLSChartTrendline, TXLSChartErrorBars) osiągalnymi z każdej serii

Rekordy tworzenia wykresów

Tworzenie arkuszy wykresów i pracy z kreatorem przyjmuje zwykłe rekordy zamiast grafów obiektów: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfoi TXLSChartSeriesStyleInfo wypełniają wpisy serii przekazywane do TXLSWorksheets.AddChartSheet i współdzielonego kreatora wykresów, a TXLSPivotChartInfo opisuje oprawę wykresu przestawnego używaną, gdy wykres jest podpięty do tabeli przestawnej

Inspekcja wypełnień wykresów klasycznych

TXLSCustomChart.GetChartModel dekoduje obsługiwane natywne tabele właściwości OfficeArt i trzeciorzędowe tabele właściwości w rekordach GelFrame, włącznie z właściwościami następującymi po złożonych wpisach ładunków; istniejąca reprezentacja kreatora pozostaje obsługiwana, a zniekształcone granice tabel pozostawiają poprzednie typowane wypełnienie bez zmian i zgłaszają nieobsługiwany rekord

Inspekcja wykresów waliduje kompletny zapisany ładunek tekstu i adnotacji przed dodaniem typowanego stanu: skrócone nazwy linii trendu albo separatory etykiet danych zgłaszają swój identyfikator rekordu przez _UnsupportedSemanticRecordID, a nagłówki SeriesText nil albo za małe zgłaszają ten rekord jako nieobsługiwany zarówno dla BIFF5, jak i BIFF8; zadeklarowana rozpiętość tekstu serii przekraczająca swój ładunek rzuca EReadError, zwalnia częściowy model i pozostawia zapisane rekordy wykresu bez zmian

Getter znaczników i inspekcja wypełnień zachowują surowy magazyn wykresu; ścieżka przechwytywania zadeklarowanego wyglądu waliduje osobno obsługiwane wykresy rdzeniowe, podczas gdy niezweryfikowane sumy kontrolne rozszerzeń bogatych tytułów albo kształtów pozostają nieobsługiwane

Ograniczone czytniki zapisanych wykresów, ciągów i czcionek

TXLSChartStoredBytes to odłączona tablica bajtów, a TXLSChartStoredRecord zawiera RecordIdi Data; te czytniki badają zachowany magazyn źródłowy bez tworzenia zdekodowanego modelu wykresu i bez wyliczania formuł

Utrzymanie tabeli ciągów współdzielonych i emisja SST

TXLSStringTable w lxStringTable podpiera ciągi współdzielone skoroszytu klasycznego; poniższe składowe pokrywają rejestrację po stronie czytnika, utrzymanie slotów i surową emisję SST dla zapisów round-trip

Załączniki PDF, podpisy i eksport HTML

Audyt obliczeń i kontrolki skoroszytu

Zgodność ze starszą oprawą PivotCache

StreamId jest zapisywany jako rekord SXStreamID ([MS-XLS] §2.4.303) i powtarzany jako pole SXDB nagłówka idstm , które musi mu być równe; SourceDataType jest zapisywany jako rekord SXVS ([MS-XLS] §2.4.317: $0001 arkusz, $0002 zewnętrzny, $0004 konsolidacja, $0010 scenariusz) i powtarzany jako pole SXDB nagłówka vsType , które musi mu być równe. Pamięci podręczne zbudowane z zakresu arkusza startują z typu arkusza, natomiast pamięci podręczne odczytane z pliku zachowują wartość niesioną przez swój podstrumień, więc twórca BIFF nigdy nie zostawia w polu SXDB nazwy rekordu, którego nie wyemitował; RawHasStorageStream oznacza pamięć podręczną wczytaną z własnego strumienia magazynu, której globalny deskryptor skoroszytu poprzedza zbuforowane rekordy

Integracja ze schowkiem i opcje wklejania

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;
      

Rozwiązywanie tekstu wyświetlanego komórki

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;
      

Obiekty sprawdzania poprawności danych klasycznego 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 }
      

Skanowanie i rozwiązywanie kolorów indeksowanych

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

Funkcje pomocnicze odwołań 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;
      

Zobacz także

• Dodatkowe elementy API klasycznego XLS
• Zaawansowane elementy API XLSX
• Rozrzedzona geometria konspektu
• Śledzenie i audyt formuł
• Przeglądarka skoroszytów