Miembros adicionales de la API de la biblioteca

Esta página completa la referencia de los tipos públicos que dan soporte a las API principales de libros, hojas de cálculo, renderizado, importación, diagnósticos y visor, pero que no requieren una guía independiente orientada a tareas

Filtrado y formato condicional

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpecy TXLSDxfStyle aceptan AttachWriteGuardOwner, que vincula el objeto de regla a su libro de trabajo propietario para que las ediciones adquieran automáticamente un bloqueo de escritura; el propietario implementa TXLSCondFormatWriteGuardOwner, cuyo único método AcquireWriteGuard entrega a la regla el bloqueo de escritura del libro. TXLSDxfStyle añade FontColorIndex con FontColorIsIndexed , además de los pares FillFgColorIndex / FillFgColorIsIndexed y FillBgColorIndex / FillBgColorIsIndexed para colores de regla indexados de paleta, y las invalidaciones de fuente diferencial FontName, FontSizey FontScheme (cadena vacía, un tamaño en puntos o una ranura de fuente del tema como major / minor) junto a los miembros existentes de negrita, cursiva, subrayado y color; cada asignación adquiere el bloqueo de escritura y marca la regla como dirty para su reemisión

TXLSConnections, TXLSDataTablesy TXLSQueryTables exponen OnAcquireWriteGuard (tipo TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuardy TXLSQueryTableAcquireWriteGuard), el enlace que sus rutas de edición usan para obtener el IXLSWorkbookWriteGuard del libro propietario antes de modificar y para hacer avanzar la generación del libro después; el bloqueo registra StartGenerationy Complete marca la escritura como terminada para que las cachés dependientes puedan recompilarse

Las conexiones de datos preservadas llevan una descripción con tipo: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) clasifica la conexión, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) registra su modo de autenticación, y cada valor de parámetro de conexión se etiqueta con TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Las tablas de datos What-if informan de su tipo de definición almacenada mediante TXLSDataTableKind

Tablas de datos What-if y agrupación de tablas dinámicas

Los umbrales de conjuntos de iconos se pueden renderizar o validar por programa: XLSCfIconSetCount informa de cuántos iconos define un TXLSIconSetType , y XLSBuildCfIconGeometry rellena un TXLSCfIconGeometry con las primitivas (TXLSCfIconPrimitive, tipo TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) y los puntos (TXLSCfIconPoint) que dibujan un icono, de modo que los renderizadores personalizados coincidan con las formas de icono integradas de Excel

Diagnósticos, trazado de fórmulas y validación

Esquemas de validación de importación

TXLSImportCheck de lxImportCheck valida una TXLSXWorksheet contra reglas propiedad de la aplicación; examina los valores escalares almacenados y los resultados de fórmulas almacenados, con coordenadas de hoja de base uno y sin conversión implícita de texto a número, de texto a fecha o de texto a 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 empieza a comprobar en la fila siguiente y prevalece sobre FirstRow; en caso contrario FirstRow es 1 por defecto; LastRow = 0 usa la última fila usada de la hoja, mientras que un LastRow positivo puede incluir celdas ausentes sin crearlas; las columnas deben estar entre 1 y 16,384 y los límites activos de filas de datos entre 1 y 1,048,576

Reglas de columna y tipos explícitos

AddRule(Column) reemplaza y libera cualquier regla previa de esa columna; los predicados por valor de tipo, rango, longitud y patrón se saltan los valores ausentes, los nulos y las cadenas vacías, mientras que irRequired los reporta; la unicidad conserva las políticas diferenciadas que se describen abajo; el espacio en blanco no vacío sigue siendo un valor; un número no cuenta como Boolean, una fecha no cuenta como número ordinario y una cadena de aspecto numérico sigue siendo texto

Asignar MinimumValue o MaximumValue activa ese límite; tanto HasMinimum como HasMaximum pueden desactivarlo de nuevo; ambos conmutadores de inclusividad son True por defecto; los límites deben ser números o fechas tipados finitos, y dos límites deben ser comparables y describir un intervalo no vacío; los límites invertidos, ausentes, incompatibles o vacíos elevan una excepción antes de que empiece la validación de la hoja

Los límites numéricos comparan valores numéricos y los límites de fecha comparan fechas; las comparaciones entero con entero conservan todos los bits de Int64 y UInt64; los valores de una categoría incompatible fallan la comprobación de rango; los predicados de longitud de texto y regex siguen inspeccionando la representación textual del escalar, y las comprobaciones regex conservan el comportamiento existente de IsMatch, así que use anclas como ^...$ cuando deba coincidir el texto completo; un regex no válido desactiva su comprobación de patrón por compatibilidad

Valores de Excel con formato de fecha

Una celda importada de Excel puede contener un serial numérico aunque su formato numérico muestre una fecha; elija un modo de serial explícitamente cuando ese sea el esquema de importación aceptado; el modo afecta solo a la validación y nunca cambia el valor almacenado de la celda

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 se declara en Variants y EncodeDate en SysUtils; los seriales numéricos deben ser no negativos y resolverse antes del 1 de enero del año 10000; los seriales fraccionarios conservan su hora del día; el sistema de 1900 rechaza todo serial desde el 60 inclusive hasta el 61 exclusivo porque ese intervalo denota el día bisiesto ficticio; el sistema de 1904 mapea el serial cero al 1 de enero de 1904

Los límites de fecha incluyen la hora del día, de modo que un máximo fijado a medianoche del 31 de diciembre excluye las horas posteriores de ese día; use un límite superior exclusivo en el 1 de enero del año siguiente cuando deba aceptarse el día final completo; las fechas textuales como 10/08/2026 siguen siendo texto sin importar el modo de serial configurado

Unicidad compuesta y comparaciones entre columnas

Las claves compuestas conservan el tipo Variant exacto y la identidad textual de cada miembro; Integer(1), Double(1), la cadena '1', un Boolean y una fecha son miembros distintos; no hay plegado de mayúsculas, normalización Unicode, análisis de configuración regional ni ambigüedad de delimitadores; combinaciones como ('ab', 'c') y ('a', 'bc') siguen siendo diferentes; cada pasada de validación inicia un índice de tuplas nuevo

Cuando SkipIncompleteRows = True, un miembro ausente, nulo o de cadena vacía excluye esa fila de la unicidad de tuplas; fijarlo en False incluye esos miembros con sus identidades Variant originales; un duplicado reporta la primera columna de la tupla como dirección de celda y la primera fila coincidente a través de FirstDuplicateRow

El irUnique de una sola columna existente conserva su comportamiento de coincidencia basado en texto y sin distinción de mayúsculas, y se salta los valores ausentes o nulos; use AddUniqueRule([Column]) cuando se exija identidad tipada estricta para una columna

Las comparaciones entre columnas nunca fuerzan cadenas a números, números a Boolean ni números ordinarios a fechas; las categorías mixtas incompatibles fallan incluso con icNotEqual; las comparaciones de cadena distinguen Unicode compuesto y descompuesto, preservan caracteres nulos embebidos y usan ordenación de prefijo corto primero; cuando SkipBlankValues = False, cualquier operando en blanco produce una infracción entre columnas

Resultados estructurados y libros de corrección

Check(Sheet) devuelve el número de infracciones, y ViolationCount más el Violation(Index) de base cero enumeran el informe; una regla de columna reporta su primer predicado fallido, mientras que las reglas de tupla y de comparación configuradas de forma independiente pueden añadir más infracciones para la misma celda; asigne valores Name significativos cuando los llamadores necesiten identificadores estables de reglas de aplicación

Las celdas de fórmula se validan usando sus valores en caché almacenados; una fórmula sin resultado en caché almacenado reporta ivFormulaCacheMissing, y un resultado de error reporta ivCellError; recalcule explícitamente antes de comprobar cuando se necesiten resultados frescos de fórmulas; la validación no accede a fuentes externas, no altera definiciones de fórmulas ni evalúa fórmulas sin caché

OnVerifyCell conserva la firma de devolución de llamada TlxImportVerifyCell y se ejecuta tras los predicados de columna aplicables correctos y las comprobaciones de unicidad; devuelve un Boolean y puede fijar un mensaje de error de la aplicación; las devoluciones de llamada deben mantener el libro y el esquema de validación sin cambios, y las escrituras del libro son rechazadas por el lease de lectura; las excepciones de la devolución de llamada se propagan y el lease se libera para operaciones posteriores

Check nunca anota, borra filas ni materializa valores empaquetados; use Annotate después de comprobar para aplicar fuentes rojas y anexar texto de error a los comentarios existentes, o llame explícitamente a KeepOnlyViolations para eliminar las filas sin infracciones y crear un libro de corrección; estos métodos modifican la hoja suministrada, así que llámelos sobre el libro previsto tras revisar el informe

La validación toma prestadas la hoja y el libro para la llamada síncrona; no adopta la propiedad de los objetos del llamador ni exige un libro propiedad de una interfaz; un lease de lectura protege las instantáneas de celdas almacenadas pertinentes y el acceso a la caché de fórmulas almacenada durante toda la comprobación

Directivas de guardado de vínculos externos

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Auditoría de cálculo y sugerencias del libro

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 tabla y de IME

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

Inspección y eliminación de paneles de tareas de complementos 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;
      

Directiva de visualización de objetos del libro

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áneas de calibración de renderizado

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;
      

Geometría de renderizado y medición de fuentes

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;
      

Importación, generación de código, comparación y supervisión

Comparación de libros

TXLSXWorkbookCompare de lxCompare compara dos instancias de TXLSXWorkbook sin recalcular fórmulas ni modificar ninguno de los dos libros; las hojas se emparejan por nombre sin distinción de mayúsculas, y cambiar solo el orden de las hojas no produce ninguna diferencia

El valor predeterminado de Options está vacío y ambas tolerancias son cero por defecto; la comparación predeterminada reporta hojas añadidas o eliminadas, celdas almacenadas añadidas o eliminadas, valores literales tipados modificados, texto de fórmulas modificado y rangos combinados añadidos o eliminados

La comparación de literales distingue números, texto, valores Boolean, fechas, errores y blancos: el número 1 difiere del texto '1', un Boolean difiere de su grafía textual, las fechas conservan su propio tipo y los errores se comparan por su código de error almacenado; los tipos de almacenamiento numérico con valores iguales comparan igual, mientras que los valores Int64 distintos siguen siendo distintos durante la comparación exacta

Options es de tipo TlxCompareOptions, un conjunto de TlxCompareOption; activar una opción añade sus diferencias a la comparación predeterminada

SetFeatureLimits(MaxBytes, MaxItems) valida ambos límites positivos antes de cambiar cualquiera de los dos ajustes; MaxFeatureBytes es 64 MiB por defecto y MaxFeatureItems es 1,000,000 por defecto, y los setters individuales conservan la misma validación atómica

Los presupuestos de funciones cubren los bytes canónicos separados agregados y las entradas contadas de ambos libros, incluidos los runs de texto enriquecido, los nodos XML de filtro, los campos de Pivot, los miembros de dominio y los valores de registro, y las conexiones de slicers o timelines; los lectores comprueban los recuentos y las entradas de texto grandes antes de construir XML nativo, exigen flujos de salida acotados y elevan EXLSXSemanticBudget cuando se supera un límite

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) valida ambos argumentos antes de cambiar cualquiera de los dos ajustes; ambos deben ser finitos y no negativos, y los setters individuales AbsoluteTolerancey RelativeTolerance usan la misma validación

Los valores literales numéricos y de caché numérica comparan igual cuando su diferencia absoluta es como máximo AbsoluteTolerance o su diferencia relativa al mayor valor absoluto es como máximo RelativeTolerance; un umbral de cero conserva la igualdad exacta, el cálculo relativo evita el desbordamiento para valores opuestos extremos, y la tolerancia no fuerza texto ni se aplica a fechas, estilos o geometría

LeftNamey RightName fijan nombres de visualización opcionales que usan las líneas de Report, con lefty right por defecto; los nombres afectan solo al informe, no al emparejamiento de hojas ni a la comparación

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 devuelve el recuento de diferencias, Count lee ese recuento después, y Diff(Index) usa indexación de base cero para devolver un TlxCompareDiff propiedad del comparador; retenga el comparador mientras lee sus entradas y vuelva a adquirir las entradas tras otra comparación correcta

Cada entrada proporciona Kind, Sheet, Rowy Col de base uno cuando procede, Ref, LeftText, RightTexty los valores tipados LeftKind / RightKind; TlxCompareValueKind contiene lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvErrory lcvFormula, y lcvNone se usa para un lado ausente o una diferencia sin valor

TlxCompareKind conserva lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAddedy lckMergeRemoved, y añade lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChangedy lckColumnGeometryChanged

Las diferencias de estilo transportan huellas canónicas estables del estilo en LeftTexty RightText; las diferencias de geometría transportan el tamaño, estado oculto, de esquema y de colapso comparados, con Ref identificando el intervalo contiguo del eje afectado, Row fijado a su primera fila y Col a cero para filas, o Col fijado a su primera columna y Row a cero para columnas

Las diferencias de funciones usan lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged o lckTimelineChanged; Change es lccChanged, lccAdded o lccRemoved, y cada lado presente transporta su huella canónica de definición mientras que un lado ausente transporta una cadena vacía

lckRichTextChanged identifica una definición de run modificada en su coordenada de celda y transporta huellas canónicas de run en LeftTexty RightText; la tolerancia numérica se aplica a literales de celda y cachés de fórmulas, mientras que las definiciones tipadas de funciones se comparan exactamente

Las referencias de funciones identifican nombres con ámbito o nombres de tabla, o usan posiciones de secuencia de base uno para definiciones de validación, formato condicional y dibujo; insertar o mover una función ordenada puede cambiar varias posiciones, mientras que las entradas de nombres a nivel de libro tienen una Sheet vacía

lckBlankStyleRegionChanged identifica un rectángulo en blanco modificado mediante Row, Col, LastRowy LastCol inclusivos, y su Ref A1; las coordenadas almacenadas las maneja la comparación ordinaria de celdas y lcoCellStyles, así que active ambas opciones de estilo para inspeccionar juntas las celdas almacenadas y las áreas en blanco

Describe formatea una entrada, mientras que Report(List) anexa las entradas formateadas a un TStrings propiedad del llamador; un cambio de valor tipado incluye etiquetas de tipo cuando los tipos difieren, y los resultados se ordenan por nombre de hoja, fila, columna, tipo de diferencia y referencia, no por el orden de inserción de celdas

La comparación retiene leases de lectura, recorre las celdas almacenadas mediante instantáneas separadas de cursor y conserva el almacenamiento empaquetado; la geometría particiona los límites de metadatos almacenados y los tramos compactos de filas repetidas, mientras que la comparación de estilos en blanco barre los límites de rectángulos activos y de celdas almacenadas sin escanear una rejilla rectangular de un millón de filas; el trabajo crece con las funciones almacenadas, las intersecciones de regiones y las diferencias reportadas

Una comparación fallida preserva el resultado correcto anterior; la asignación de una tolerancia no válida también preserva los ajustes y el resultado existentes, mientras que pasar un libro nil borra el resultado y devuelve cero

Esta comparación cubre el contenido de celdas almacenadas de la fachada XLSX y las definiciones tipadas seleccionadas de funciones; la grafía de fórmulas de nombres, validaciones, formatos condicionales, tablas y gráficos se normaliza mediante el analizador semántico de fórmulas, mientras que las fórmulas calculadas de Pivot conservan su texto de definición almacenado

Los filtros de tabla aceptan las formas admitidas personalizadas, de lista de valores, de grupo de fechas, de color, de icono, dinámicas y de recuento superior, y las condiciones de ordenación; las columnas de filtro independientes y las entradas de conjuntos de valores normalizan su orden, los valores predeterminados Boolean y las grafías numéricas se normalizan, y el orden de las condiciones de ordenación sigue siendo significativo

La comparación tipada de Pivot, slicers y timelines resuelve los orígenes locales de hoja admitidos y los enlaces no OLAP sin refrescar ni evaluar disponibilidad; las pistas de disponibilidad nativas de slicers son metadatos de visualización derivados, mientras que las selecciones de miembros y los metadatos nativos de ordenación reconocidos sí se comparan

Las propiedades nativas opacas de dibujo, los modelos binarios incompletos de Pivot, los orígenes externos u OLAP de Pivot, los registros suplementarios en bruto de tablas dinámicas y el XML de extensión, el XML de filtro desconocido, y los atributos o hijos de extensión de slicers o timelines no modelados elevan EXLSSemanticSnapshot; la preservación de esos datos no implica equivalencia semántica

Las funciones importadas seleccionadas de tablas dinámicas y PivotCache también validan el XML nativo preservado antes de comparar la proyección tipada, incluidos los metadatos anidados de campo y los registros de caché; los namespaces, atributos, hijos y cargas de extensión desconocidos fallan explícitamente dentro de los mismos límites cooperativos de funciones, mientras que los enlaces modelados de caché de slicer siguen admitidos

TSimpleDomNode.RawName expone el QName original del elemento junto al Name normalizado por el lector, lo que permite una inspección sensible a namespaces sin cambiar la coincidencia de nombres existente del analizador

Los ajustes del libro y los metadatos opacos del paquete quedan fuera de la comparación; la comparación de estilos base no evalúa la apariencia de formatos condicionales ni de estilos de tabla, y la comparación de dibujos preserva los límites admitidos de imagen, cuadro de texto, gráfico y grupos ordenados de la instantánea semántica

Propiedades efectivas de texto enriquecido

TMsoFbtOpt.StoredPids devuelve los identificadores de propiedades OfficeArt almacenados en orden de clasificación, mientras que TMsoFbtSp.PersistentFlags expone las banderas nativas de la forma sin asignar propiedades ni anclas

TMsoShapeContainer.HasPreservedObjectData identifica los bytes de cola OBJ retenidos; HasOrdinaryEmbeddedPictureObjectData comprueba que las colas de imagen contengan solo registros reconocidos de formato de portapapeles y de banderas de imagen a cero, y rechaza los registros enlazados o desconocidos sin copiar la carga útil

TMSOShapeTextBox.HasValidTextRuns comprueba los límites de runs TXO almacenados y los campos reservados sin crear runs; TMsoDrawing.HasUnmodeledAppearance identifica los datos nativos de dibujo que el analizador tipado omite, lo que permite que la captura rechace explícitamente la apariencia sin resolver

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSety ColorSet distinguen las propiedades de fuente heredadas de las invalidaciones explícitas, incluidas las banderas false, none, baseline y los colores automáticos; los setters marcan la propiedad como explícita incluso cuando su valor iguala el predeterminado inicial del run nuevo

TXLSXRichText.HasUnsupportedAppearance reporta las propiedades nativas enriquecidas que el modelo tipado de runs no puede representar; la captura portable y la comparación efectiva de texto enriquecido rechazan esos runs explícitamente, mientras que las propiedades de run compartidas/inline admitidas y el espacio en blanco conservan su semántica importada

La comparación efectiva de texto enriquecido aplica las invalidaciones false explícitas antes de fusionar los runs adyacentes iguales; las propiedades heredadas y las borradas explícitamente siguen siendo distintas durante la deduplicación de cadenas compartidas y los round-trips XML admitidos

TXMLReader.ResolveNamespaceUri(Prefix, Uri) resuelve el enlace de namespace en ámbito actual sin cambiar la posición del lector, devolviendo false cuando no existe enlace; un prefijo vacío solicita el namespace predeterminado, y los QNames en bruto siguen disponibles para una inspección sensible a namespaces

Los registros inmutables de rich/scene, la extensión de origen de captura y el contrato de transferencia HXRSNP02 se describen en Salida portable sin interfaz

Inspección separada de estilos y ejes

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) devuelve un TXLSSemanticCellStyle separado para coordenadas de base uno válidas, resolviendo estilos almacenados y empaquetados, valores predeterminados de hoja, superposiciones de estilo aplicables, formatos de fecha implícitos, colores indexados y colores de tema sin materializar celdas ni cambiar los pools de estilos; la llamada pública adquiere un lease de lectura y excluye las reglas de formato condicional y de estilo de tabla

TXLSXWorksheet.GetStoredAxisSpans(IsRow) devuelve TXLSXAxisSpans, un array de registros TXLSXAxisSpan con FirstIndexy LastIndex inclusivos de base uno; reporta las huellas de metadatos de tamaño, ocultación, esquema y colapso, conserva los tramos compactos de altos de filas repetidas y deja el valor predeterminado efectivo de la hoja disponible a través de sus propiedades ordinarias

Los tramos devueltos describen huellas de metadatos almacenados en lugar de una partición normalizada disjunta; las aplicaciones que comparan dos ejes pueden combinar sus límites primero y último, e inspeccionar luego el estado efectivo una vez por cada intervalo resultante

TXLSXWorksheet.GetStoredStyleRegions devuelve TXLSXStyleRegions separados con límites FirstRow, FirstCol, LastRowy LastCol inclusivos para las huellas compactas de formato virtual; esas huellas pueden solaparse, y quienes llaman leen su apariencia efectiva con ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) devuelve entradas TXLSXSemanticFeatures separadas con una Key estable, bytes canónicos de Definitiony un ItemCount contado; los límites positivos opcionales son 64 MiB y 1,000,000 entradas por defecto

TXLSXSemanticFeatureKind contiene xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelinesy xlsxSemanticTimelineCaches

Los nombres definidos y los tres tipos de caché usan ámbito de todo el libro y permiten una hoja nil; los demás tipos exigen una hoja perteneciente al libro, las reglas y los dibujos conservan su secuencia almacenada, y los arrays y búferes devueltos son copias propiedad del llamador; estos lectores adquieren leases de lectura y heredan la cobertura tipada y el comportamiento explícito de datos no admitidos descrito arriba

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) devuelve bytes canónicos separados de runs para coordenadas de base uno, o un búfer vacío cuando no existe texto enriquecido e IncludePlainText es false; el ConsumedItems: PInteger opcional recibe el recuento de runs capturado, y la captura de texto plano conserva el almacenamiento empaquetado

TXLSPivotCacheField.GroupItemTypes[Index] expone el tipo tipado correspondiente a GroupItemLabels[Index] y rechaza un índice fuera del dominio de etiquetas agrupadas almacenado

Metadatos de fórmulas y devoluciones de llamada de consultas de Pivot

TXLSGetCellFormulaTexty TXLSCalculator.OnGetCellFormulaText leen el texto de expresión almacenado usando un SheetIndex de base uno y Row/Col de base cero, devolviendo lxOk o un código de error tipado y respetando la protección de fórmulas ocultas; TXLSGetPivotTabley OnGetPivotTable localizan una tabla prestada usando un SheetIndex de base uno y coordenadas de rango de base cero

Los motores de libros conectan estas devoluciones de llamada opcionales en contextos de cálculo normales, de solo lectura y aislados; las devoluciones de llamada no recalculan destinos, no refrescan orígenes de Pivot ni transfieren propiedad

TXLSPivotDataConstraint almacena un FieldName y un Item tipado, y TXLSPivotDataConstraints recopila pares campo/elemento; TXLSPivotTable.GetDataValue consulta un agregado visible admitido de una instantánea separada local de tabla/caché y IntersectsQueryRange usa límites de hoja de base uno que incluyen las celdas modeladas de filtro de informe

TlxPivotQueryBudget recibe estimaciones de trabajo y memoria de forma síncrona y devuelve si la evaluación puede continuar; EXLSPivotQueryBudgety EXLSPivotQueryUnsupported distinguen los límites agotados de los modelos de caché o agregado no admitidos

TXLSPivotCache.QueryModelIsComplete registra la disponibilidad de consulta decodificada con independencia de la completitud de la reproducción en bruto de BIFF; QueryRecordsValid expone la validez de los registros importados y SetQueryRecordValidity aplica la precedencia del lector de formatos sin refrescar los registros

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

Pase el RawByteString devuelto directamente a AddRawString o a una operación de flujo orientada a bytes; convertirlo a un AnsiString predeterminado puede recodificar sus bytes en sistemas FPC nativos

Nombres definidos clásicos y bloques de fórmulas de array

Pools clásicos de fuentes, formatos y estilos

Aplicaciones auxiliares de paquetes y almacenamiento binario

Novedades de dibujo y del visor de libros

Paginación, salida de imágenes e impresión

Modelos de gráficos clásicos y objetos de gráfico de hojas de cálculo

Modelo de decodificación de gráficos con tipos

El estado decodificado del gráfico se expone como registros y enumeraciones sencillas, de modo que el código de inspección nunca tenga que recorrer registros BIFF crudos: TXLSChartInfo transporta el resumen del gráfico decodificado con TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), cada serie informa de TXLSChartSeriesType, y TXLSChart3DState junto con TXLSChart3DInfo describen las vistas tridimensionales. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) y TXLSChartLegendPosition clasifican ejes y leyendas, mientras que el modelo de eje de fechas usa TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) y TXLSChartDateValues. TXLSCustomChart expone el modelo decodificado a través de TXLSChartInfo; las anotaciones de líneas de tendencia y de barras de error son objetos con tipo (TXLSChartTrendline, TXLSChartErrorBars) accesibles desde cada serie

Registros de creación de gráficos

La creación de hojas de gráfico y del constructor acepta registros sencillos en lugar de grafos de objetos: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfoy TXLSChartSeriesStyleInfo rellenan las entradas de serie que se pasan a TXLSWorksheets.AddChartSheet y al constructor de gráficos compartido, y TXLSPivotChartInfo describe el encuadre de gráfico dinámico que se usa cuando un gráfico se vincula a una tabla dinámica

Inspección de rellenos de gráficos clásicos

TXLSCustomChart.GetChartModel decodifica las tablas de propiedades OfficeArt nativas admitidas y las tablas de propiedades terciarias de los registros GelFrame, incluidas las propiedades que siguen a entradas de carga útil compleja; la representación del constructor existente sigue admitida, y los límites de tabla mal formados dejan el relleno tipado previo sin cambios y reportan el registro no admitido

La inspección del gráfico valida la carga útil completa de texto y anotación almacenada antes de añadir estado tipado: los nombres de línea de tendencia o los separadores de etiquetas de datos truncados reportan su id de registro a través de _UnsupportedSemanticRecordID, mientras que las cabeceras SeriesText nulas o demasiado cortas reportan ese registro como no admitido tanto para BIFF5 como para BIFF8; una extensión declarada de texto de serie que excede su carga útil eleva EReadError, libera el modelo parcial y deja los registros del gráfico almacenados sin cambios

El getter de marcador y la inspección de rellenos preservan el almacenamiento en bruto del gráfico; la ruta de captura de apariencia declarada valida por separado los gráficos núcleo admitidos, mientras que las sumas de verificación de título enriquecido o de extensiones de forma sin verificar siguen sin estar admitidas

Lectores acotados de gráficos, cadenas y fuentes almacenados

TXLSChartStoredBytes es un array de bytes separado y TXLSChartStoredRecord contiene RecordIdy Data; estos lectores inspeccionan el almacenamiento de origen retenido sin crear un modelo de gráfico decodificado ni evaluar fórmulas

Mantenimiento de la tabla de cadenas compartidas y emisión de SST

TXLSStringTable de lxStringTable respalda las cadenas compartidas del libro clásico; los miembros de abajo cubren el registro del lado del lector, el mantenimiento de ranuras y la emisión SST en bruto para guardados round-trip

Adjuntos PDF, firmas y exportación HTML

Auditoría de cálculo y controles del libro

Compatibilidad del framing heredado de PivotCache

StreamId se escribe como el registro SXStreamID ([MS-XLS] §2.4.303) y se repite como el campo SXDB de la cabecera idstm , con el que debe coincidir; SourceDataType se escribe como el registro SXVS ([MS-XLS] §2.4.317: $0001 hoja de cálculo, $0002 externo, $0004 consolidación, $0010 escenario) y se repite como el campo SXDB de la cabecera vsType , con el que debe coincidir. Las cachés construidas a partir de un rango de hoja de cálculo empiezan con el tipo de hoja de cálculo, mientras que las cachés leídas de vuelta desde un archivo conservan el valor que su subflujo transportaba, de modo que el escritor BIFF nunca deja un campo SXDB que nombre un registro que no emitió; RawHasStorageStream marca una caché cargada desde su propio flujo de almacenamiento, cuyo descriptor global del libro precede a los registros en caché

Integración con el portapapeles y opciones de pegado

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;
      

Resolución del texto de visualización de celdas

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 de validación de datos clásicos

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 }
      

Escaneo y resolución de colores indexados

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

Aplicaciones auxiliares de referencias 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;
      

Véase también

• Miembros adicionales de la API XLS clásica
• Miembros avanzados de la API XLSX
• Geometría de esquemas dispersos
• Trazado y auditoría de fórmulas
• Visor de libros