Membros adicionais da API da biblioteca

Esta página completa a referência dos tipos públicos que dão suporte às APIs principais de pasta de trabalho, planilha, renderização, importação, diagnósticos e visualizador, mas não exigem um guia separado orientado a tarefas

Filtragem e formatação condicional

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpece TXLSDxfStyle aceitam AttachWriteGuardOwner, vinculando o objeto de regra à sua pasta de trabalho proprietária para que as edições adquiram automaticamente uma proteção de gravação; o proprietário implementa TXLSCondFormatWriteGuardOwner, cujo único método AcquireWriteGuard entrega à regra a proteção de gravação da pasta de trabalho. TXLSDxfStyle adiciona FontColorIndex com FontColorIsIndexed , além dos pares FillFgColorIndex / FillFgColorIsIndexed e FillBgColorIndex / FillBgColorIsIndexed para cores de regra por índice de paleta, e os overrides de fonte diferencial FontName, FontSizee FontScheme (string vazia, um tamanho em pontos ou um slot de fonte do tema como major / minor) ao lado dos membros existentes de negrito, itálico, sublinhado e cor; cada atribuição adquire a proteção de gravação e marca a regra como dirty para reemissão

TXLSConnections, TXLSDataTablese TXLSQueryTables expõem OnAcquireWriteGuard (tipos TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuarde TXLSQueryTableAcquireWriteGuard), o gancho que seus caminhos de edição usam para obter o IXLSWorkbookWriteGuard da pasta de trabalho proprietária antes de mutar e para avançar a geração da pasta de trabalho em seguida; a proteção registra StartGeneration, e Complete marca a gravação como concluída para que caches dependentes possam ser reconstruídos

Conexões de dados preservadas carregam uma descrição tipada: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) classifica a conexão, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) registra seu modo de autenticação, e cada valor de parâmetro de conexão é marcado com TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Tabelas de dados what-if informam o tipo de definição armazenado por meio de TXLSDataTableKind

Tabelas de dados What-If e agrupamento dinâmico

Limites de conjuntos de ícones podem ser renderizados ou validados programaticamente: XLSCfIconSetCount informa quantos ícones um TXLSIconSetType define, e XLSBuildCfIconGeometry preenche um TXLSCfIconGeometry com as primitivas (TXLSCfIconPrimitive, tipo TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) e os pontos (TXLSCfIconPoint) que desenham um ícone, para que renderizadores personalizados acompanhem as formas de ícone internas do Excel

Diagnósticos, rastreamento de fórmulas e validação

Esquemas de validação de importação

TXLSImportCheck de lxImportCheck valida uma TXLSXWorksheet contra regras de propriedade da aplicação; ele examina valores escalares armazenados e resultados de fórmulas armazenados, com coordenadas de planilha de base 1 e nenhuma conversão implícita de texto para número, de texto para data ou de texto para booleano

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 inicia a verificação na linha seguinte e tem precedência sobre FirstRow; caso contrário, FirstRow tem como padrão 1; LastRow = 0 usa a última linha usada da planilha, enquanto um LastRow positivo pode incluir células ausentes sem criá-las; as colunas devem estar entre 1 e 16.384, e os limites ativos de linhas de dados entre 1 e 1.048.576

Regras de coluna e tipos explícitos

AddRule(Column) substitui e libera qualquer regra anterior para aquela coluna; os predicados por valor de tipo, intervalo, comprimento e padrão pulam valores ausentes, nulls e strings vazias, enquanto irRequired os reporta; a unicidade retém as políticas distintas descritas abaixo; espaço em branco não vazio permanece um valor; um número não se qualifica como booleano, uma data não se qualifica como número comum, e uma string com aparência numérica permanece texto

Atribuir MinimumValue ou MaximumValue habilita aquele limite; HasMinimum ou HasMaximum pode desabilitá-lo novamente; ambos os switches de inclusividade têm True como padrão; os limites devem ser números ou datas tipados finitos, e dois limites devem ser comparáveis e descrever um intervalo não vazio; limites invertidos, ausentes, incompatíveis ou vazios geram exceção antes do início da validação da planilha

Limites numéricos comparam valores numéricos e limites de data comparam datas; comparações de inteiro para inteiro preservam todos os bits de Int64 e UInt64; valores de uma categoria incompatível falham na verificação de intervalo; predicados de comprimento de texto e de regex continuam a inspecionar a representação de texto do escalar, e as verificações de regex retêm o comportamento IsMatch existente, então use âncoras como ^...$ quando o texto completo deve corresponder; uma regex inválida desabilita sua verificação de padrão por compatibilidade

Valores do Excel com formato de data

Uma célula importada do Excel pode conter um serial numérico mesmo quando seu formato numérico exibe uma data; escolha um modo de serial explicitamente quando esse for o esquema de importação aceito; o modo afeta apenas a validação e nunca muda o valor armazenado da célula

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 é declarado em Variantse EncodeDate em SysUtils; seriais numéricos devem ser não negativos e resolver antes de 1º de janeiro de 10000; seriais fracionários retêm sua hora do dia; o sistema 1900 rejeita todo serial de 60 inclusive a 61 exclusivo, porque esse intervalo denota o dia bissexto fictício; o sistema 1904 mapeia o serial zero para 1º de janeiro de 1904

Limites de data incluem a hora do dia, de modo que um máximo definido como meia-noite de 31 de dezembro exclui horários posteriores naquele dia; use um limite superior exclusivo em 1º de janeiro do ano seguinte quando o dia final inteiro deve ser aceito; datas textuais como 10/08/2026 permanecem texto, independentemente do modo de serial configurado

Unicidade composta e comparações entre colunas

Chaves compostas retêm o tipo Variant exato e a identidade de texto de cada membro; Integer(1), Double(1), a string '1', um booleano e uma data são membros distintos; não há case folding, normalização Unicode, análise de localidade nem ambiguidade de delimitador; combinações como ('ab', 'c')e ('a', 'bc') permanecem diferentes; cada passada de validação inicia um índice de tuplas novo

Quando SkipIncompleteRows = True, um membro ausente, nulo ou de string vazia exclui aquela linha da unicidade de tuplas; defini-lo como False inclui esses membros com suas identidades Variant originais; uma duplicata informa a primeira coluna da tupla como endereço de célula e a primeira linha correspondente por meio de FirstDuplicateRow

O irUnique existente de coluna única retém seu comportamento de correspondência baseado em texto e insensível a maiúsculas, e pula valores ausentes ou nulos; use AddUniqueRule([Column]) quando identidade tipada estrita for exigida para uma coluna

Comparações entre colunas nunca convertem strings em números, números em booleanos ou números comuns em datas; categorias mistas incompatíveis falham mesmo para icNotEqual; comparações de strings distinguem Unicode composto e decomposto, preservam caracteres nulos embutidos e usam ordenação de prefixo mais curto primeiro; quando SkipBlankValues = False, qualquer operando em branco produz uma violação entre colunas

Resultados estruturados e pastas de trabalho de correção

Check(Sheet) retorna o número de violações, e ViolationCount mais Violation(Index) de base zero enumeram o relatório; uma regra de coluna informa seu primeiro predicado que falha, enquanto regras de tupla e de comparação configuradas de forma independente podem acrescentar mais violações para a mesma célula; atribua valores significativos de Name quando os chamadores precisarem de identificadores estáveis de regras da aplicação

Células de fórmula são validadas usando seus valores em cache armazenados; uma fórmula sem resultado em cache armazenado reporta ivFormulaCacheMissing, e um resultado de erro reporta ivCellError; recalcule explicitamente antes de verificar quando resultados de fórmulas atualizados forem exigidos; a validação não acessa fontes externas, não altera definições de fórmulas nem avalia fórmulas sem cache

OnVerifyCell retém a assinatura de callback TlxImportVerifyCell e roda após predicados de coluna aplicáveis bem-sucedidos e verificações de unicidade; ele retorna um booleano e pode definir uma mensagem de erro da aplicação; os callbacks devem manter a pasta de trabalho e o esquema de validação inalterados, e gravações na pasta de trabalho são rejeitadas pela concessão de leitura; exceções de callback propagam, e a concessão é liberada para operações subsequentes

Check nunca anota, exclui linhas nem materializa valores empacotados; use Annotate após a verificação para aplicar fontes vermelhas e acrescentar texto de erro a comentários existentes, ou chame explicitamente KeepOnlyViolations para remover linhas sem violação e criar uma pasta de trabalho de correção; esses métodos modificam a planilha fornecida, então chame-os na pasta de trabalho pretendida após revisar o relatório

A validação empresta a planilha e a pasta de trabalho para a chamada síncrona; ela não adota a propriedade de objetos do chamador nem exige uma pasta de trabalho de propriedade de interface; uma concessão de leitura protege os snapshots relevantes de células armazenadas e o acesso ao cache de fórmulas armazenado durante toda a verificação

Políticas de salvamento de vínculos externos

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Auditoria de cálculo e dicas da pasta de trabalho

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;
      

Estado de fórmulas de tabela e IME

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

Inspeção e remoção de painéis de tarefas de suplementos da Web

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

Política de exibição de objetos da pasta de trabalho

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;
      

Valores e instantâneos de calibração de renderização

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 de renderização e medição de fontes

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;
      

Importação, geração de código, comparação e monitoramento

Comparação de pastas de trabalho

TXLSXWorkbookCompare em lxCompare compara duas instâncias de TXLSXWorkbook sem recalcular fórmulas nem modificar qualquer uma das pastas de trabalho; as planilhas são emparelhadas pelo nome sem diferenciar maiúsculas, e mudar apenas a ordem das planilhas não produz uma diferença

O valor padrão de Options é vazio, e ambas as tolerâncias têm zero como padrão; a comparação padrão reporta planilhas adicionadas ou removidas, células armazenadas adicionadas ou removidas, valores literais tipados alterados, texto de fórmulas alterado e intervalos mesclados adicionados ou removidos

A comparação de literais distingue números, texto, valores booleanos, datas, erros e células em branco: o número 1 difere do texto '1', um booleano difere de sua grafia de texto, datas retêm o próprio tipo, e erros comparam pelo código de erro armazenado; tipos de armazenamento numérico com valores iguais comparam como iguais, enquanto valores Int64 distintos permanecem distintos durante a comparação exata

Options tem o tipo TlxCompareOptions, um conjunto de TlxCompareOption; habilitar uma opção acrescenta as diferenças dela à comparação padrão

SetFeatureLimits(MaxBytes, MaxItems) valida ambos os limites positivos antes de alterar qualquer uma das configurações; MaxFeatureBytes tem 64 MiB como padrão e MaxFeatureItems tem 1.000.000 como padrão, e os setters individuais preservam a mesma validação atômica

Os orçamentos de recursos cobrem os bytes canônicos destacados agregados e as entradas contadas de ambas as pastas de trabalho, incluindo runs de rich-text, nós XML de filtro, campos de tabela dinâmica, membros de domínio e valores de registro, e conexões de slicer ou de timeline; os leitores verificam contagens e entradas de texto grandes antes de construir XML nativo, impõem streams de saída limitados, e geram EXLSXSemanticBudget quando um limite é excedido

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) valida ambos os argumentos antes de alterar qualquer uma das configurações; ambos devem ser finitos e não negativos, e os setters individuais AbsoluteTolerancee RelativeTolerance usam a mesma validação

Valores literais numéricos e valores de cache numéricos comparam como iguais quando sua diferença absoluta é no máximo AbsoluteTolerance ou sua diferença relativa ao maior valor absoluto é no máximo RelativeTolerance; um limiar zero retém igualdade exata, o cálculo relativo evita overflow para valores extremos opostos, e a tolerância não converte texto nem se aplica a datas, estilos ou geometria

LeftNamee RightName definem nomes de exibição opcionais usados pelas linhas de Report, com lefte right como padrão; os nomes afetam apenas o relatório, e não o emparelhamento de planilhas nem a comparação

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 retorna a contagem de diferenças, Count lê essa contagem depois, e Diff(Index) usa indexação de base zero para retornar um TlxCompareDiff de propriedade do comparador; retenha o comparador enquanto lê as entradas dele, e readquira as entradas após outra comparação bem-sucedida

Cada entrada fornece Kind, Sheet, Rowe Col de base 1 quando aplicável, Ref, LeftText, RightTexte valores tipados LeftKind / RightKind; TlxCompareValueKind contém lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvErrore lcvFormula, com lcvNone usado para um lado ausente ou uma diferença que não é de valor

TlxCompareKind retém lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAddede lckMergeRemoved, e acrescenta lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChangede lckColumnGeometryChanged

Diferenças de estilo carregam fingerprints canônicos estáveis de estilo em LeftTexte RightText; diferenças de geometria carregam o estado comparado de tamanho, oculto, estrutura e recolhido, com Ref identificando o intervalo contíguo de eixo afetado, Row definido como a primeira linha dele e Col como zero para linhas, ou Col definido como a primeira coluna dele e Row como zero para colunas

Diferenças de recursos usam lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChangedou lckTimelineChanged; Change é lccChanged, lccAddedou lccRemoved, e cada lado presente carrega seu fingerprint canônico de definição, enquanto um lado ausente carrega uma string vazia

lckRichTextChanged identifica uma definição de run alterada na coordenada de célula dela e carrega fingerprints canônicos de runs em LeftTexte RightText; a tolerância numérica se aplica a literais de célula e a caches de fórmulas, enquanto definições tipadas de recursos comparam de forma exata

Referências de recursos identificam nomes com escopo ou nomes de tabelas, ou usam posições de sequência de base 1 para definições de validação, de formato condicional e de desenhos; inserir ou mover um recurso ordenado pode mudar várias posições, enquanto entradas de nomes no nível da pasta de trabalho têm um Sheetvazio

lckBlankStyleRegionChanged identifica um retângulo em branco alterado por meio de Row, Col, LastRowe LastCol inclusivos, e o Ref em A1 dele; coordenadas armazenadas são tratadas pela comparação comum de células e por lcoCellStyles, então habilite ambas as opções de estilo para inspecionar células armazenadas e áreas em branco juntas

Describe formata uma entrada, enquanto Report(List) acrescenta as entradas formatadas a um TStrings de propriedade do chamador; uma mudança de valor tipado inclui rótulos de tipo quando os tipos diferem, e os resultados são ordenados por nome de planilha, linha, coluna, tipo de diferença e referência, em vez da ordem de inserção de células

A comparação mantém concessões de leitura, percorre células armazenadas por meio de snapshots destacados de cursor, e retém o armazenamento empacotado; a geometria particiona fronteiras de metadados armazenados e spans compactos de linhas repetidas, enquanto a comparação de estilos em branco varre as fronteiras de retângulo ativo e de células armazenadas sem varrer uma grade retangular de um milhão de linhas; o trabalho cresce com os recursos armazenados, as interseções de regiões e as diferenças reportadas

Uma comparação com falha preserva o resultado bem-sucedido anterior; atribuição de tolerância inválida também preserva as configurações e o resultado existentes, enquanto passar uma pasta de trabalho nil limpa o resultado e retorna zero

Esta comparação cobre o conteúdo de células armazenadas da facade XLSX e definições tipadas selecionadas de recursos; a grafia de fórmulas de nomes, validações, formatos condicionais, tabelas e gráficos é normalizada por meio do parser semântico de fórmulas, enquanto fórmulas calculadas de tabelas dinâmicas retêm o texto de definição armazenado delas

Filtros de tabela aceitam formas suportadas personalizadas, de lista de valores, de grupo de datas, de cor, de ícone, dinâmicas e de contagem superior, além de condições de ordenação; colunas de filtro independentes e entradas de conjuntos de valores normalizam a ordem, padrões booleanos e grafias numéricas são normalizados, e a ordem das condições de ordenação permanece significativa

A comparação tipada de tabelas dinâmicas, slicers e timelines resolve origens de planilha locais suportadas e vínculos não OLAP sem atualizar nem avaliar disponibilidade; dicas nativas de disponibilidade de slicer são metadados de exibição derivados, enquanto seleções de membros e metadados nativos de ordenação reconhecidos são comparados

Propriedades nativas de desenho opacas, modelos binários incompletos de tabelas dinâmicas, origens de tabelas dinâmicas externas ou OLAP, records suplementares brutos de tabelas dinâmicas e XML de extensão, XML de filtro desconhecido, e atributos ou filhos de extensão de slicer ou timeline sem modelo geram EXLSSemanticSnapshot; a preservação desses dados não implica equivalência semântica

Recursos selecionados de tabelas dinâmicas e de PivotCache importados também validam o XML nativo preservado antes de comparar a projeção tipada, incluindo metadados aninhados de campos e registros de cache; namespaces, atributos, filhos e payloads de extensão desconhecidos falham explicitamente dentro dos mesmos limites cooperativos de recursos, enquanto vínculos modelados de cache de slicer permanecem suportados

TSimpleDomNode.RawName expõe o QName original do elemento ao lado do Name normalizado pelo leitor, permitindo inspeção sensível a namespaces sem alterar a correspondência de nomes existente do parser

Configurações da pasta de trabalho e metadados opacos do pacote permanecem fora da comparação; a comparação de estilos base não avalia aparência de formato condicional nem de estilo de tabela, e a comparação de desenhos preserva os limites suportados de imagem, caixa de texto, gráfico e grupos ordenados do snapshot semântico

Propriedades efetivas de rich-text

TMsoFbtOpt.StoredPids retorna identificadores de propriedades do OfficeArt armazenados em ordem classificada, enquanto TMsoFbtSp.PersistentFlags expõe flags nativas de forma sem alocar propriedades nem âncoras

TMsoShapeContainer.HasPreservedObjectData identifica bytes de cauda OBJ retidos; HasOrdinaryEmbeddedPictureObjectData verifica que caudas de imagem contêm apenas records reconhecidos de formato de área de transferência e de flag de imagem zero, e rejeita records vinculados ou desconhecidos sem copiar o payload

TMSOShapeTextBox.HasValidTextRuns verifica fronteiras de runs TXO armazenadas e campos reservados sem criar runs; TMsoDrawing.HasUnmodeledAppearance identifica dados nativos de desenho pulados pelo parser tipado, permitindo que a captura rejeite explicitamente aparência não resolvida

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSete ColorSet distinguem propriedades de fonte herdadas de overrides explícitos, incluindo flags falsas, none, baseline e cores automáticas; os setters marcam a propriedade como explícita mesmo quando seu valor é igual ao padrão inicial do novo run

TXLSXRichText.HasUnsupportedAppearance reporta propriedades nativas de rich que o modelo tipado de runs não consegue representar; a captura portátil e a comparação efetiva de rich-text rejeitam tais runs explicitamente, enquanto propriedades suportadas de runs compartilhados/inline e espaço em branco retêm a semântica importada delas

A comparação efetiva de rich-text aplica overrides falsos explícitos antes de coalescer runs adjacentes iguais; propriedades herdadas e explicitamente limpas permanecem distintas durante a deduplicação de strings compartilhadas e round trips XML suportados

TXMLReader.ResolveNamespaceUri(Prefix, Uri) resolve o vínculo de namespace atual em escopo sem mudar a posição do leitor, retornando false quando não existe vínculo; um prefixo vazio pede o namespace padrão, e QNames brutos permanecem disponíveis para inspeção sensível a namespaces

Os records imutáveis de rich/scene, a extensão de origem de captura e o contrato de transferência HXRSNP02 são descritos em saída headless portátil

Inspeção destacada de estilos e eixos

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) retorna um TXLSSemanticCellStyle destacado para coordenadas válidas de base 1, resolvendo estilos armazenados e empacotados, padrões da planilha, overlays de estilo aplicáveis, formatos de data implícitos, cores indexadas e cores de tema sem materializar células nem alterar pools de estilos; a chamada pública adquire uma concessão de leitura e exclui regras de formato condicional e de estilo de tabela

TXLSXWorksheet.GetStoredAxisSpans(IsRow) retorna TXLSXAxisSpans, um array de records TXLSXAxisSpan com FirstIndexe LastIndex inclusivos de base 1; ele reporta os footprints de metadados de tamanho, oculto, estrutura e recolhido, preserva spans compactos de alturas de linhas repetidas, e deixa o padrão efetivo da planilha disponível por meio de suas propriedades comuns

Os spans retornados descrevem footprints de metadados armazenados, e não uma partição normalizada disjunta; aplicações que comparam dois eixos podem combinar as fronteiras de início e de fim deles, e então inspecionar o estado efetivo uma vez por intervalo resultante

TXLSXWorksheet.GetStoredStyleRegions retorna TXLSXStyleRegions destacados contendo fronteiras inclusivas de FirstRow, FirstCol, LastRowe LastCol para footprints compactos de formatação virtual; esses footprints podem se sobrepor, e os chamadores leem a aparência efetiva deles com ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) retorna entradas destacadas de TXLSXSemanticFeatures com uma Key estável, bytes canônicos de Definition, e uma ItemCount contada; limites positivos opcionais têm como padrão 64 MiB e 1.000.000 de entradas

TXLSXSemanticFeatureKind contém xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelinese xlsxSemanticTimelineCaches

Nomes definidos e os três tipos de cache usam escopo de pasta de trabalho inteira e permitem uma planilha nil; os outros tipos exigem uma planilha pertencente à pasta de trabalho, regras e desenhos retêm a sequência armazenada deles, e os arrays e buffers retornados são cópias de propriedade do chamador; esses leitores adquirem concessões de leitura e herdam a cobertura tipada e o comportamento explícito de dados sem suporte descritos acima

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) retorna bytes canônicos destacados de runs para coordenadas de base 1, ou um buffer vazio quando não existe rich text e IncludePlainText é false; o ConsumedItems: PInteger opcional recebe a contagem de runs capturados, e a captura de texto simples retém o armazenamento empacotado

TXLSPivotCacheField.GroupItemTypes[Index] expõe o tipo tipado correspondente a GroupItemLabels[Index]e rejeita um índice fora do domínio armazenado de rótulos agrupados

Metadados de fórmulas e callbacks de consulta de tabelas dinâmicas

TXLSGetCellFormulaTexte TXLSCalculator.OnGetCellFormulaText leem texto de expressão armazenado usando um SheetIndex de base 1 e Row/Col de base zero, retornando lxOk ou um código de erro tipado e respeitando a proteção de fórmula oculta; TXLSGetPivotTablee OnGetPivotTable localizam uma tabela emprestada usando um SheetIndex de base 1 e coordenadas de intervalo de base zero

Os motores de pasta de trabalho conectam esses callbacks opcionais em contextos de cálculo normal, somente leitura e isolado; os callbacks não recalculam alvos, não atualizam origens de tabelas dinâmicas nem transferem propriedade

TXLSPivotDataConstraint armazena um FieldNamee um Item tipado, com TXLSPivotDataConstraints coletando pares campo/item; TXLSPivotTable.GetDataValue consulta um agregado visível suportado de um snapshot destacado de tabela/cache local, e IntersectsQueryRange usa limites de planilha de base 1 incluindo células modeladas de filtro de relatório

TlxPivotQueryBudget recebe estimativas de trabalho e de memória de forma síncrona e retorna se a avaliação pode continuar; EXLSPivotQueryBudgete EXLSPivotQueryUnsupported distinguem limites esgotados de modelos de cache ou de agregado sem suporte

TXLSPivotCache.QueryModelIsComplete registra a prontidão de consultas decodificadas de forma independente da completude da repetição bruta do BIFF; QueryRecordsValid expõe a validade de registros importados, e SetQueryRecordValidity aplica a precedência do leitor de formato sem atualizar registros

Bytes de página de código explícitos

Passe o RawByteString retornado diretamente para AddRawString ou para uma operação de stream orientada a bytes; convertê-lo em um AnsiString padrão pode recodificar os bytes dele em sistemas FPC nativos

Nomes definidos clássicos e blocos de fórmulas de matriz

Pools clássicos de fontes, formatos e estilos

Auxiliares de pacote e armazenamento binário

Adições de desenho e do visualizador de pastas de trabalho

Paginação, saída de imagem e impressão

Modelos de gráfico clássicos e objetos de gráfico de planilha

Modelo de decodificação tipado de gráficos

O estado decodificado do gráfico é exposto como records e enums simples para que o código de inspeção nunca precise percorrer registros BIFF brutos: TXLSChartInfo carrega o resumo decodificado do gráfico com TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), cada série informa um TXLSChartSeriesType, e TXLSChart3DState mais TXLSChart3DInfo descrevem visualizações tridimensionais. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) e TXLSChartLegendPosition classificam eixos e legendas, enquanto o modelo de eixo de data usa TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) e TXLSChartDateValues. TXLSCustomChart expõe o modelo decodificado por meio de TXLSChartInfo; anotações de linha de tendência e barras de erro são objetos tipados (TXLSChartTrendline, TXLSChartErrorBars) acessíveis a partir de cada série

Records de autoria de gráficos

A autoria de planilhas de gráfico e do construtor aceita records simples em vez de grafos de objetos: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfoe TXLSChartSeriesStyleInfo preenchem as entradas de série passadas a TXLSWorksheets.AddChartSheet e ao construtor de gráficos compartilhado, e TXLSPivotChartInfo descreve o enquadramento de gráfico dinâmico usado quando um gráfico é anexado a uma tabela dinâmica

Inspeção de preenchimento de gráficos clássicos

TXLSCustomChart.GetChartModel decodifica tabelas de propriedades nativas do OfficeArt suportadas e tabelas de propriedades terciárias em records GelFrame, incluindo propriedades que seguem entradas de payload complexas; a representação existente do construtor permanece suportada, e limites de tabela malformados deixam o preenchimento tipado anterior inalterado e reportam o record sem suporte

A inspeção de gráficos valida a carga armazenada completa de texto e de anotações antes de acrescentar estado tipado: nomes de linhas de tendência truncados ou separadores de rótulos de dados reportam o id do record deles por meio de _UnsupportedSemanticRecordID, enquanto cabeçalhos SeriesText nil ou pequenos demais reportam esse record como sem suporte tanto para BIFF5 quanto para BIFF8; uma extensão declarada de texto de série que excede o payload dela gera EReadError, libera o modelo parcial e deixa os registros armazenados do gráfico inalterados

O getter de marcador e a inspeção de preenchimento preservam o armazenamento bruto do gráfico; o caminho de captura de aparência declarada valida separadamente os gráficos de núcleo suportados, enquanto checksums de extensão de título rico ou de forma não verificados permanecem sem suporte

Leitores limitados de gráficos, strings e fontes armazenados

TXLSChartStoredBytes é um array de bytes destacado, e TXLSChartStoredRecord contém RecordIde Data; esses leitores inspecionam o armazenamento de origem retido sem criar um modelo de gráfico decodificado nem avaliar fórmulas

Manutenção da tabela de strings compartilhadas e emissão de SST

TXLSStringTable em lxStringTable sustenta as strings compartilhadas da pasta de trabalho clássica; os membros abaixo cobrem registro no lado do leitor, manutenção de slots e emissão bruta de SST para salvamentos de round-trip

Anexos PDF, assinaturas e exportação HTML

Auditoria de cálculo e controles da pasta de trabalho

Compatibilidade de enquadramento legado do PivotCache

StreamId é gravado como o registro SXStreamID ([MS-XLS] §2.4.303) e repetido como o campo SXDB do cabeçalho idstm , que deve ser igual a ele; o SourceDataType é gravado como o registro SXVS ([MS-XLS] §2.4.317: $0001 planilha, $0002 externo, $0004 consolidação, $0010 cenário) e repetido como o campo SXDB do cabeçalho vsType , que deve ser igual a ele. Caches construídos a partir de um intervalo de planilha começam no tipo planilha, enquanto caches lidos de volta de um arquivo mantêm o valor que seu subfluxo carregava, de modo que o gravador BIFF nunca deixa um campo SXDB nomeando um registro que não emitiu; RawHasStorageStream marca um cache carregado de seu próprio fluxo de armazenamento cujo descritor global da pasta de trabalho precede os registros em cache

Integração com a área de transferência e opções de colagem

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;
      

Resolução do texto de exibição da célula

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;
      

Objetos clássicos de validação de dados

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 }
      

Varredura e resolução de cores indexadas

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

Auxiliares de referência 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;
      

Veja também

• Membros adicionais da API XLS clássica
• Membros avançados da API XLSX
• Geometria de estrutura de tópicos esparsa
• Rastreamento e auditoria de fórmulas
• Visualizador de pasta de trabalho