라이브러리 추가 API 멤버

이 페이지는 기본 통합 문서, 워크시트, 렌더링, 가져오기, 진단 및 뷰어 API를 지원하면서 별도의 작업 지향 가이드가 필요하지 않은 공용 형식에 대한 참조를 완성합니다

필터링 및 조건부 서식

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec및 TXLSDxfStyle 는 AttachWriteGuardOwner를 허용하여 규칙 개체를 소유 통합 문서에 연결하므로 편집 시 쓰기 가드가 자동으로 획득됩니다. 소유자는 TXLSCondFormatWriteGuardOwner를 구현하며, 유일한 AcquireWriteGuard 메서드가 규칙에 통합 문서의 쓰기 가드를 넘겨줍니다. TXLSDxfStyle 는 팔레트 인덱스 규칙 색을 위해 FontColorIndex 가 있는 FontColorIsIndexed 와 FillFgColorIndex / FillFgColorIsIndexed , FillBgColorIndex / FillBgColorIsIndexed 쌍에 더해, 기존 굵게·이탤릭·밑줄·색상 멤버와 함께 차등 폰트 재정의인 FontName, FontSize, FontScheme (빈 문자열, 포인트 크기, 또는 major / minor같은 테마 폰트 슬롯)를 추가합니다. 대입이 일어날 때마다 쓰기 가드를 획득하고 다시 내보내도록 규칙을 dirty로 표시합니다

TXLSConnections, TXLSDataTables및 TXLSQueryTables 는 OnAcquireWriteGuard 를 노출합니다. 이는 편집 경로가 변경 전에 소유 통합 문서의 TXLSConnectionAcquireWriteGuard를 획득한 후 통합 문서 세대를 진행하기 위해 사용하는 훅입니다. 가드는 TXLSDataTableAcquireWriteGuard을 기록하고 TXLSQueryTableAcquireWriteGuard가 쓰기 완료를 표시하여 종속 캐시를 다시 빌드할 수 있게 합니다 IXLSWorkbookWriteGuard 변경 전에 호출하고 그 후에는 통합 문서 세대(generation)를 올리는 데 씁니다. 이 가드는 다음을 기록합니다: StartGeneration, and Complete 은(는) 쓰기가 끝났음을 표시해 종속 캐시가 다시 빌드될 수 있게 합니다

보존된 데이터 연결에는 형식화된 설명이 따릅니다. TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo)가 연결을 분류하고, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt)가 인증 모드를 기록하며, 각 연결 매개변수 값은 TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell)로 태그가 붙습니다. What-If 데이터 테이블은 저장된 정의 종류를 TXLSDataTableKind

What-If 데이터 테이블 및 피벗 그룹화

아이콘 집합 임계값은 프로그래밍 방식으로 렌더링하거나 검증할 수 있습니다. XLSCfIconSetCount 는 TXLSIconSetType 이 정의하는 아이콘 수를 보고하고, XLSBuildCfIconGeometry 는 아이콘 하나를 그리는 프리미티브( TXLSCfIconGeometry , 종류TXLSCfIconPrimitive: TXLSCfIconPrimitiveKind, cfipPolygon, cfipEllipse, cfipRect)와 포인트( cfipLine)로TXLSCfIconPoint를 채우므로 사용자 지정 렌더러도 Excel의 기본 제공 아이콘 모양과 일치합니다

진단, 수식 추적 및 유효성 검사

가져오기 검증 스키마

lxImportCheck의 TXLSImportCheck는 애플리케이션이 소유한 규칙을 기준으로 TXLSXWorksheet를 검증합니다. 저장된 스칼라 값과 저장된 수식 결과를 검사하며, 1 기반 워크시트 좌표를 사용하고 텍스트→숫자, 텍스트→날짜, 텍스트→Boolean 암시 변환은 없습니다

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이면 다음 행부터 검사를 시작하고 FirstRow보다 우선합니다. 그렇지 않으면 FirstRow 기본값은 1입니다. LastRow = 0은 워크시트의 마지막 사용 행을 쓰고, 양수 LastRow는 셀을 만들지 않고 없는 셀을 포함할 수 있습니다. 열은 1~16,384 범위 안에 있어야 하고 활성 데이터 행 경계는 1~1,048,576 안에 있어야 합니다

열 규칙과 명시적 타입

AddRule(Column)은 그 열의 이전 규칙을 교체해 해제합니다. 값 타입·범위·길이·패턴 술어는 누락 값, null, 빈 문자열을 건너뛰지만 irRequired는 이를 보고합니다. 유일성은 아래에서 설명하는 별개 정책을 유지합니다. 비어 있지 않은 공백은 여전히 값입니다. 숫자는 Boolean이 될 수 없고, 날짜는 일반 숫자가 될 수 없으며, 숫자처럼 보이는 문자열은 텍스트로 남습니다

MinimumValue나 MaximumValue를 할당하면 그 경계가 켜지고, HasMinimum이나 HasMaximum으로 다시 끌 수 있습니다. 두 경계 포함 스위치의 기본값은 True입니다. 경계는 유한한 형식화 숫자나 날짜여야 하고 두 경계는 비교 가능하며 빈 구간이 아닌 구간을 기술해야 합니다. 뒤집히거나, 없거나, 호환되지 않거나, 빈 경계는 워크시트 검증이 시작되기 전에 예외를 발생시킵니다

숫자 경계는 숫자 값을, 날짜 경계는 날짜를 비교합니다. 정수 간 비교는 Int64와 UInt64의 모든 비트를 보존합니다. 호환되지 않는 범주의 값은 범위 검사에 실패합니다. 텍스트 길이와 정규식 술어는 계속 스칼라의 텍스트 표현을 검사하고, 정규식 검사는 기존 IsMatch 동작을 유지하므로 전체 텍스트가 일치해야 할 때는 ^...$ 같은 앵커를 쓰세요. 잘못된 정규식은 호환성을 위해 패턴 검사를 비활성화합니다

날짜 서식 Excel 값

Excel에서 가져온 셀은 숫자 서식이 날짜를 표시하더라도 숫자 serial을 담을 수 있습니다. 그것이 받아들이는 가져오기 스키마라면 serial 모드를 명시적으로 고르세요. 모드는 검증에만 영향을 주고 저장된 셀 값은 절대 바꾸지 않습니다

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에, EncodeDate는 SysUtils에 선언되어 있습니다. 숫자 serial은 음수가 아니어야 하고 10000년 1월 1일 전에 해석되어야 합니다. 소수 serial은 시각 부분을 유지합니다. 1900 체계는 60(포함)부터 61(미포함) 직전까지 모든 serial을 거부합니다. 그 구간은 가상의 윤날을 뜻합니다. 1904 체계는 serial 0을 1904년 1월 1일로 매핑합니다

날짜 경계는 시각 부분을 포함하므로, 12월 31일 자정으로 설정한 최댓값은 그날의 이후 시각을 제외합니다. 마지막 날 전체를 받아들여야 한다면 다음 해 1월 1일을 제외 상한으로 쓰세요. 10/08/2026 같은 텍스트 날짜는 구성된 serial 모드와 무관하게 텍스트로 남습니다

복합 유일성과 열 간 비교

복합 키는 각 멤버의 정확한 Variant 타입과 텍스트 ID를 유지합니다. Integer(1), Double(1), 문자열 '1', Boolean, 날짜는 서로 다른 멤버입니다. case folding, 유니코드 정규화, 로캘 파싱, 구분자 모호성은 없습니다. ('ab', 'c')와 ('a', 'bc') 같은 조합은 다른 채로 남고, 각 검증 패스는 새 튜플 인덱스로 시작합니다

SkipIncompleteRows = True이면 누락, null, 빈 문자열 멤버가 있는 행은 튜플 유일성에서 제외됩니다. False로 두면 그런 멤버를 원래 Variant ID로 포함합니다. 중복은 첫 튜플 열을 셀 주소로 보고하고 FirstDuplicateRow로 첫 일치 행을 알려 줍니다

기존 단일 열 irUnique는 텍스트 기반 대소문자 무시 매칭 동작을 유지하고 누락이나 null 값을 건너뜁니다. 한 열에 엄격한 형식화 ID가 필요하면 AddUniqueRule([Column])을 쓰세요

열 간 비교는 문자열→숫자, 숫자→Boolean, 일반 숫자→날짜 강제 변환을 절대 하지 않습니다. 섞인 호환되지 않는 범주는 icNotEqual에서도 실패합니다. 문자열 비교는 결합형·분해형 유니코드를 구별하고 삽입된 NUL 문자를 보존하며 짧은 접두어 우선 순서를 사용합니다. SkipBlankValues = False이면 어느 쪽 빈 피연산자든 열 간 위반이 됩니다

구조화된 결과와 수정 통합 문서

Check(Sheet)는 위반 수를 반환하고, ViolationCount와 0 기반 Violation(Index)가 보고서를 열거합니다. 한 열 규칙은 첫 실패 술어를 보고하고, 독립 구성된 튜플·비교 규칙은 같은 셀에 위반을 더 추가할 수 있습니다. 호출자가 안정적인 애플리케이션 규칙 식별자를 필요로 하면 의미 있는 Name 값을 지정하세요

수식 셀은 저장된 캐시 값으로 검증됩니다. 저장된 캐시 결과가 없는 수식은 ivFormulaCacheMissing을, 오류 결과는 ivCellError를 보고합니다. 새 수식 결과가 필요하면 검사 전에 명시적으로 재계산하세요. 검증은 외부 소스에 접근하거나 수식 정의를 바꾸거나 캐시 없는 수식을 평가하지 않습니다

OnVerifyCell은 TlxImportVerifyCell 콜백 시그니처를 유지하며, 적용 가능한 열 술어와 유일성 검사가 성공한 뒤 실행됩니다. Boolean을 반환하고 애플리케이션 오류 메시지를 설정할 수 있습니다. 콜백은 통합 문서와 검증 스키마를 바꾸지 않아야 하고 통합 문서 쓰기는 읽기 리스에 의해 거부됩니다. 콜백 예외는 전파되고 리스는 해제되어 이후 작업에 쓸 수 있습니다

Check는 절대 주석 달기, 행 삭제, 패킹 값 구체화를 하지 않습니다. 검사 뒤 Annotate로 빨간 폰트를 적용하고 기존 메모에 오류 텍스트를 덧붙이거나, KeepOnlyViolations를 명시적으로 호출해 위반하지 않은 행을 제거하고 수정 통합 문서를 만드세요. 이 메서드들은 제공된 워크시트를 수정하므로 보고서를 검토한 뒤 의도한 통합 문서에 호출하세요

검증은 동기 호출 동안 워크시트와 통합 문서를 빌려 씁니다. 호출자의 개체 소유권을 채택하거나 인터페이스 소유 통합 문서를 요구하지 않습니다. 읽기 리스가 검사 내내 관련 저장 셀 스냅샷과 저장 수식 캐시 접근을 보호합니다

외부 링크 저장 정책

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

계산 감사 및 통합 문서 힌트

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;
      

테이블 수식 및 IME 상태

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

웹 추가 기능 작업 창 검사 및 제거

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

통합 문서 개체 표시 정책

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;
      

렌더링 보정 값 및 스냅샷

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;
      

렌더링 지오메트리 및 글꼴 측정

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;
      

가져오기, 코드 생성, 비교 및 모니터링

통합 문서 비교

lxCompare의 TXLSXWorkbookCompare는 수식을 재계산하거나 어느 통합 문서도 수정하지 않고 두 TXLSXWorkbook 인스턴스를 비교합니다. 시트는 대소문자 무시 이름으로 짝을 이루고, 시트 순서만 바꾸는 것은 차이를 만들지 않습니다

Options 기본값은 빈 집합이고 두 허용 오차의 기본값은 0입니다. 기본 비교는 추가·제거된 시트, 추가·제거된 저장 셀, 바뀐 형식화 리터럴 값, 바뀐 수식 텍스트, 추가·제거된 병합 범위를 보고합니다

리터럴 비교는 숫자, 텍스트, Boolean 값, 날짜, 오류, 빈 칸을 구별합니다. 숫자 1은 텍스트 '1'과 다르고, Boolean은 자기 텍스트 철자와 다르며, 날짜는 자기 타입을 유지하고, 오류는 저장된 오류 코드로 비교합니다. 값이 같은 숫자 저장 타입은 동등하게 비교되지만, 정확 비교에서 서로 다른 Int64 값은 계속 구별됩니다

Options는 TlxCompareOption의 집합인 TlxCompareOptions 타입입니다. 옵션을 켜면 그 차이가 기본 비교에 더해집니다

SetFeatureLimits(MaxBytes, MaxItems)는 설정을 바꾸기 전에 두 양수 한도를 검증합니다. MaxFeatureBytes 기본값은 64 MiB, MaxFeatureItems 기본값은 1,000,000이며, 개별 setter도 같은 원자적 검증을 유지합니다

기능 예산은 두 통합 문서의 집계 분리 정식 바이트와 셉니다 항목(리치 텍스트 run, 필터 XML 노드, 피벗 필드, 도메인 멤버와 레코드 값, Slicer·타임라인 연결 포함)을 커버합니다. 리더는 네이티브 XML을 만들기 전에 개수와 큰 텍스트 입력을 검사하고, 경계가 있는 출력 스트림을 강제하며, 한도 초과 시 EXLSXSemanticBudget을 발생시킵니다

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance)는 설정을 바꾸기 전에 두 인수를 검증합니다. 둘 다 유한하고 음수가 아니어야 하며, 개별 AbsoluteTolerance, RelativeTolerance setter도 같은 검증을 사용합니다

숫자 리터럴과 숫자 캐시 값은 절대 차이가 AbsoluteTolerance 이하이거나 더 큰 절대값 기준 상대 차이가 RelativeTolerance 이하일 때 동등하게 비교됩니다. 0 임계값은 정확한 동등성을 유지하고, 상대 계산은 극단적 부호 반대 값에서 오버플로를 피하며, 허용 오차는 텍스트를 강제 변환하지 않고 날짜·스타일·지오메트리에는 적용되지 않습니다

LeftName과 RightName은 Report 줄이 쓰는 선택적 표시 이름을 설정하며 기본값은 left, right입니다. 이름은 보고에만 영향을 주고 시트 짝짓기나 비교에는 영향을 주지 않습니다

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는 차이 수를 반환하고, Count는 그 뒤에 개수를 읽으며, Diff(Index)는 0 기반 인덱싱으로 comparer 소유 TlxCompareDiff를 반환합니다. 항목을 읽는 동안 comparer를 유지하고, 또 다른 성공 비교 뒤에는 항목을 다시 얻으세요

각 항목은 Kind, Sheet, 해당 시 1 기반 Row·Col, Ref, LeftText, RightText, 형식화된 LeftKind / RightKind 값을 제공합니다. TlxCompareValueKind는 lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvError, lcvFormula를 담고, lcvNone은 없는 쪽이나 값이 아닌 차이에 쓰입니다

TlxCompareKind는 lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAdded, lckMergeRemoved를 유지하고 lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChanged, lckColumnGeometryChanged를 더합니다

스타일 차이는 LeftText와 RightText에 안정적인 정식 스타일 지문을 담고, 지오메트리 차이는 비교한 크기·숨김·윤곽·축소 상태를 담습니다. Ref는 영향받은 연속 축 구간을 식별하고, 행은 Row에 첫 행과 Col 0, 열은 Col에 첫 열과 Row 0을 설정합니다

기능 차이는 lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged, lckTimelineChanged를 사용합니다. Change는 lccChanged, lccAdded, lccRemoved 중 하나이고, 존재하는 쪽은 자기 정식 정의 지문을, 없는 쪽은 빈 문자열을 담습니다

lckRichTextChanged는 셀 좌표에서 바뀐 run 정의를 식별하고 LeftText, RightText에 정식 run 지문을 담습니다. 숫자 허용 오차는 셀 리터럴과 수식 캐시에 적용되지만, 형식화된 기능 정의는 정확히 비교됩니다

기능 참조는 범위 지정 이름이나 표 이름을 식별하거나, 유효성 검사·조건부 서식·드로잉 정의에 1 기반 순서 위치를 씁니다. 정렬된 기능을 삽입하거나 이동하면 여러 위치가 바뀔 수 있고, 통합 문서 수준 이름 항목의 Sheet는 비어 있습니다

lckBlankStyleRegionChanged는 Row, Col, 경계 포함 LastRow, LastCol, A1 Ref로 바뀐 빈 사각형을 식별합니다. 저장 좌표는 일반 셀 비교와 lcoCellStyles가 처리하므로, 저장 셀과 빈 영역을 함께 검사하려면 두 스타일 옵션을 모두 켜세요

Describe는 항목 하나를 서식화하고, Report(List)는 서식화된 항목을 호출자 소유 TStrings에 덧붙입니다. 형식화 값 변경은 타입이 다를 때 타입 레이블을 포함하고, 결과는 셀 삽입 순서가 아니라 시트 이름, 행, 열, 차이 종류, 참조 순으로 정렬됩니다

비교는 읽기 리스를 잡고 분리된 커서 스냅샷으로 저장 셀을 순회하며 패킹 저장소를 유지합니다. 지오메트리는 저장 메타데이터 경계와 압축 반복 행 구간을 분할하고, 빈 스타일 비교는 사각형 백만 행 그리드를 훑지 않고 활성 사각형과 저장 셀 경계를 훑습니다. 작업량은 저장 기능, 영역 교차, 보고된 차이에 따라 늘어납니다

실패한 비교는 이전 성공 결과를 보존합니다. 잘못된 허용 오차 할당도 기존 설정과 결과를 유지하고, nil 통합 문서를 넘기면 결과를 지우고 0을 반환합니다

이 비교는 XLSX 파사드의 저장 셀 내용과 선택된 형식화 기능 정의를 다룹니다. 이름·유효성 검사·조건부 서식·표·차트 수식 철자는 의미 수식 파서를 통해 정규화되지만, 피벗 계산 수식은 저장된 정의 텍스트를 유지합니다

표 필터는 지원되는 사용자 지정·값 목록·날짜 그룹·색·아이콘·동적·top-count 형태와 정렬 조건을 받습니다. 독립 필터 열과 값 집합 항목은 순서를 정규화하고, Boolean 기본값과 숫자 철자는 정규화되며, 정렬 조건 순서는 여전히 의미가 있습니다

형식화된 피벗·Slicer·타임라인 비교는 새로 고치거나 가용성을 평가하지 않고 지원되는 로컬 워크시트 소스와 비-OLAP 바인딩을 해석합니다. 네이티브 Slicer 가용성 힌트는 파생된 표시 메타데이터이고, 멤버 선택과 인식된 네이티브 정렬 메타데이터는 비교 대상입니다

불투명한 네이티브 드로잉 속성, 불완전한 바이너리 피벗 모델, 외부 또는 OLAP 피벗 소스, 원시 피벗 테이블 보조 레코드와 확장 XML, 알 수 없는 필터 XML, 모델링되지 않은 Slicer·타임라인 확장 속성이나 자식은 EXLSSemanticSnapshot을 발생시킵니다. 그런 데이터의 보존이 의미적 동등성을 뜻하지는 않습니다

선택된 가져온 피벗 테이블·피벗 캐시 기능은 형식화 프로젝션을 비교하기 전에 보존된 네이티브 XML(중첩 필드 메타데이터와 캐시 레코드 포함)도 검증합니다. 알 수 없는 네임스페이스, 속성, 자식, 확장 페이로드는 같은 협조적 기능 한도 안에서 명시적으로 실패하고, 모델링된 Slicer 캐시 바인딩은 계속 지원됩니다

TSimpleDomNode.RawName은 리더가 정규화한 Name과 함께 원래 요소 QName을 노출해 기존 파서 이름 매칭을 바꾸지 않고 네임스페이스 민감 검사를 가능하게 합니다

통합 문서 설정과 불투명 패키지 메타데이터는 비교 밖에 있습니다. 기본 스타일 비교는 조건부 서식이나 테이블 스타일 모양을 평가하지 않고, 드로잉 비교는 의미 스냅샷의 지원되는 이미지·텍스트 상자·차트·정렬된 그룹 경계를 유지합니다

유효 리치 텍스트 속성

TMsoFbtOpt.StoredPids는 저장된 OfficeArt 속성 식별자를 정렬 순으로 반환하고, TMsoFbtSp.PersistentFlags는 속성이나 앵커를 할당하지 않고 네이티브 도형 플래그를 노출합니다

TMsoShapeContainer.HasPreservedObjectData는 보존된 OBJ 꼬리 바이트를 식별합니다. HasOrdinaryEmbeddedPictureObjectData는 그림 꼬리에 인식된 클립보드 형식과 0 그림 플래그 레코드만 있는지 검사하고, 연결되거나 알 수 없는 레코드는 페이로드를 복사하지 않고 거부합니다

TMSOShapeTextBox.HasValidTextRuns는 run을 만들지 않고 저장된 TXO run 경계와 예약 필드를 검사합니다. TMsoDrawing.HasUnmodeledAppearance은 형식화 파서가 건너뛴 네이티브 드로잉 데이터를 식별해, 캡처가 해소되지 않은 모양을 명시적으로 거부할 수 있게 합니다

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSet, ColorSet은 상속 폰트 속성과 명시적 재정의(false 플래그, none, baseline, 자동 색 포함)를 구별합니다. setter는 값이 새 run의 초기 기본값과 같아도 속성을 명시적 표시합니다

TXLSXRichText.HasUnsupportedAppearance는 형식화 run 모델이 표현할 수 없는 네이티브 리치 속성을 보고합니다. 포터블 캡처와 유효 리치 텍스트 비교는 그런 run을 명시적으로 거부하고, 지원되는 shared/inline run 속성과 공백은 가져온 의미론을 유지합니다

유효 리치 텍스트 비교는 인접한 동일 run을 합치기 전에 명시적 false 재정의를 적용합니다. 상속 속성과 명시적으로 지워진 속성은 공유 문자열 중복 제거와 지원되는 XML 라운드트립에서 계속 구별됩니다

TXMLReader.ResolveNamespaceUri(Prefix, Uri)는 리더 위치를 바꾸지 않고 현재 범위 안의 네임스페이스 바인딩을 해석하며, 바인딩이 없으면 false를 반환합니다. 빈 접두어는 기본 네임스페이스를 요청하고, 원시 QName은 네임스페이스 민감 검사에 계속 쓸 수 있습니다

불변 리치/씬 레코드, 캡처 소스 확장, HXRSNP02 전송 계약은 포터블 헤드리스 출력에 설명되어 있습니다

분리된 스타일과 축 검사

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col)은 유효한 1 기반 좌표에 대해 분리된 TXLSSemanticCellStyle을 반환합니다. 저장·패킹 스타일, 워크시트 기본값, 적용 가능한 스타일 오버레이, 암시적 날짜 서식, 인덱스 색, 테마 색을 셀을 구체화하거나 스타일 풀을 바꾸지 않고 해석합니다. 공개 호출은 읽기 리스를 획득하고 조건부 서식과 테이블 스타일 규칙은 제외합니다

TXLSXWorksheet.GetStoredAxisSpans(IsRow)은 경계 포함 1 기반 FirstIndex, LastIndex를 가진 TXLSXAxisSpan 레코드 배열인 TXLSXAxisSpans를 반환합니다. 크기·숨김·윤곽·축소 메타데이터 발자국을 보고하고, 압축된 반복 행 높이 구간을 유지하며, 워크시트의 유효 기본값은 기존 속성으로 계속 접근할 수 있습니다

반환된 구간은 서로 겹치지 않는 정규화 분할이 아니라 저장 메타데이터 발자국을 기술합니다. 두 축을 비교하는 애플리케이션은 첫·마지막 경계를 합친 뒤 결과 구간마다 유효 상태를 한 번 검사하면 됩니다

TXLSXWorksheet.GetStoredStyleRegions은 압축된 가상 서식 발자국의 경계 포함 FirstRow, FirstCol, LastRow, LastCol을 담은 분리된 TXLSXStyleRegions를 반환합니다. 이 발자국은 겹칠 수 있고, 호출자는 ReadSemanticCellStyle로 유효 모양을 읽습니다

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems)은 안정적인 Key, 정식 Definition 바이트, 셉니다 ItemCount를 가진 분리된 TXLSXSemanticFeatures 항목을 반환합니다. 선택적 양수 한도의 기본값은 64 MiB와 1,000,000 항목입니다

TXLSXSemanticFeatureKind는 xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelines, xlsxSemanticTimelineCaches를 담습니다

정의된 이름과 세 캐시 종류는 통합 문서 전체 범위를 쓰며 nil 시트를 허용합니다. 나머지 종류는 통합 문서에 속한 워크시트가 필요하고, 규칙과 드로잉은 저장된 순서를 유지하며, 반환된 배열과 버퍼는 호출자 소유 복사본입니다. 이 리더들은 읽기 리스를 획득하고 위에서 설명한 형식화 커버리지와 명시적 미지원 데이터 동작을 상속합니다

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems)은 1 기반 좌표의 분리된 정식 run 바이트를 반환하고, 리치 텍스트가 없고 IncludePlainText가 false면 빈 버퍼를 반환합니다. 선택적 ConsumedItems: PInteger가 캡처한 run 수를 받고, 평문 캡처는 패킹 저장소를 유지합니다

TXLSPivotCacheField.GroupItemTypes[Index]는 GroupItemLabels[Index]에 대응하는 형식화 종류를 노출하고, 저장된 그룹화 레이블 도메인 밖 인덱스는 거부합니다

수식 메타데이터와 피벗 조회 콜백

TXLSGetCellFormulaText과 TXLSCalculator.OnGetCellFormulaText은 1 기반 SheetIndex와 0 기반 Row/Col로 저장된 식 텍스트를 읽고, lxOk 또는 형식화 오류 코드를 반환하며 수식 숨김 보호를 존중합니다. TXLSGetPivotTable과 OnGetPivotTable은 1 기반 SheetIndex와 0 기반 범위 좌표로 빌려 온 표를 찾습니다

통합 문서 엔진은 일반·읽기 전용·격리 계산 컨텍스트에서 이 선택적 콜백들을 연결합니다. 콜백은 대상을 재계산하거나 피벗 소스를 새로 고치거나 소유권을 이전하지 않습니다

TXLSPivotDataConstraint는 FieldName과 형식화 Item을 저장하고, TXLSPivotDataConstraints가 field/item 쌍을 모읍니다. TXLSPivotTable.GetDataValue는 분리된 로컬 표/캐시 스냅샷에서 표시되는 지원 집계 하나를 조회하고, IntersectsQueryRange는 모델링된 보고서 필터 셀을 포함한 1 기반 워크시트 경계를 사용합니다

TlxPivotQueryBudget는 작업과 메모리 추정치를 동기로 받고 평가를 계속할 수 있는지 반환합니다. EXLSPivotQueryBudget와 EXLSPivotQueryUnsupported는 소진된 한도와 지원되지 않는 캐시·집계 모델을 구별합니다

TXLSPivotCache.QueryModelIsComplete는 디코딩된 조회 준비 상태를 BIFF 원시 재생 완전성과 별개로 기록합니다. QueryRecordsValid는 가져온 레코드 유효성을 노출하고, SetQueryRecordValidity는 레코드를 새로 고치지 않고 형식 리더 우선순위를 적용합니다

명시적 코드페이지 바이트

반환된 RawByteString은 AddRawString이나 바이트 지향 스트림 작업에 직접 넘기세요. 기본 AnsiString으로 변환하면 네이티브 FPC 시스템에서 바이트가 다시 인코딩될 수 있습니다

클래식 정의된 이름과 배열 수식 블록

클래식 폰트, 서식, 스타일 풀

패키지 및 이진 저장소 도우미

그리기 및 통합 문서 뷰어 추가

페이지 매김, 이미지 출력 및 인쇄

클래식 차트 모델 및 워크시트 차트 개체

형식화된 차트 디코드 모델

디코드된 차트 상태는 일반 레코드와 열거형으로 노출되므로 검사 코드가 raw BIFF 레코드를 직접 훑을 필요가 없습니다. TXLSChartInfo 는 TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble)와 함께 디코드된 차트 요약을 전달하고, 각 계열은 TXLSChartSeriesType을 보고하며, TXLSChart3DState 와 TXLSChart3DInfo 는 3차원 뷰를 설명합니다. TXLSChartAxisType (catCategory, catValue, catSeries, catDate)와 TXLSChartLegendPosition 은 축과 범례를 분류하고, 날짜 축 모델은 TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears)와 TXLSChartDateValues를 사용합니다. TXLSCustomChart 는 디코드된 모델을 TXLSChartInfo로 노출하며, 추세선과 오차 막대 주석은 각 계열에서 접근할 수 있는 형식화된 개체(TXLSChartTrendline, TXLSChartErrorBars)입니다

차트 작성 레코드

차트 시트와 작성기에 대한 작성은 개체 그래프 대신 일반 레코드를 받습니다. TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfo및 TXLSChartSeriesStyleInfo 는 TXLSWorksheets.AddChartSheet 와 공유 차트 작성기에 전달되는 계열 항목을 채우고, TXLSPivotChartInfo 는 차트가 피벗 테이블에 붙을 때 사용되는 피벗 차트 프레이밍을 설명합니다

클래식 차트 채우기 검사

TXLSCustomChart.GetChartModel은 복합 페이로드 항목 뒤에 오는 속성을 포함해 GelFrame 레코드에서 지원되는 네이티브 OfficeArt 속성 테이블과 3차 속성 테이블을 디코드합니다. 기존 작성기 표현은 계속 지원되고, 잘못된 테이블 경계는 이전 형식화 채우기를 그대로 두고 미지원 레코드를 보고합니다

차트 검사는 형식화된 상태를 추가하기 전에 완전한 저장 텍스트와 주석 페이로드를 검증합니다. 잘린 추세선 이름이나 데이터 레이블 구분자는 _UnsupportedSemanticRecordID로 자기 레코드 ID를 보고하고, nil이거나 크기가 부족한 SeriesText 헤더는 BIFF5와 BIFF8 양쪽에서 그 레코드를 미지원으로 보고합니다. 페이로드를 초과하는 선언된 series-text 범위는 EReadError를 발생시키고 부분 모델을 해제하며 저장된 차트 레코드는 그대로 둡니다

마커 getter와 채우기 검사는 raw 차트 저장소를 보존합니다. 선언된 모양 캡처 경로는 지원되는 코어 차트를 별도로 검증하고, 검증되지 않은 리치 제목이나 도형 확장 체크섬은 계속 미지원입니다

경계가 있는 저장 차트, 문자열, 폰트 리더

TXLSChartStoredBytes는 분리된 바이트 배열이고 TXLSChartStoredRecord는 RecordId와 Data를 담습니다. 이 리더들은 디코드된 차트 모델을 만들거나 수식을 평가하지 않고 보존된 소스 저장소를 검사합니다

공유 문자열 테이블 유지 관리와 SST 출력

lxStringTable의 TXLSStringTable은 클래식 통합 문서의 공유 문자열을 뒷받침합니다. 아래 멤버들은 라운드트립 저장을 위한 리더 측 등록, 슬롯 유지 관리, 원시 SST 출력을 다룹니다

PDF 첨부, 서명 및 HTML 내보내기

계산 감사 및 통합 문서 컨트롤

레거시 PivotCache 프레이밍 호환성

StreamId 는 SXStreamID 레코드([MS-XLS] §2.4.303)로 쓰이고 반드시 같아야 하는 SXDB 헤더의 idstm 필드로 반복됩니다. SourceDataType 은 SXVS 레코드([MS-XLS] §2.4.317: $0001 worksheet, $0002 external, $0004 consolidation, $0010 scenario)로 쓰이고 반드시 같아야 하는 SXDB 헤더의 vsType 필드로 반복됩니다. 워크시트 범위에서 만든 캐시는 worksheet 유형으로 시작하고, 파일에서 다시 읽은 캐시는 자신의 하위 스트림이 담고 있던 값을 유지하므로 BIFF 작성기는 자신이 내보내지 않은 레코드를 가리키는 SXDB 필드를 남기지 않습니다. RawHasStorageStream 은 자체 저장소 스트림에서 로드되었고 통합 문서 전역 디스크립터가 캐시된 레코드보다 앞서는 캐시를 표시합니다

클립보드 통합 및 붙여넣기 옵션

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;
      

셀 표시 텍스트 결정

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;
      

클래식 데이터 유효성 검사 개체

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 }
      

인덱스 색 스캔 및 해석

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 참조 도우미

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;
      

참고 항목

• 추가 클래식 XLS API 멤버
• 고급 XLSX API 멤버
• 스파스 아웃라인 지오메트리
• 수식 추적 및 감사
• 통합 문서 뷰어