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 de trabajo, hojas de cálculo, renderizado, importación, diagnósticos y visor, pero que no requieren una guía separada orientada a tareas

Filtrado y formato condicional

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec y TXLSDxfStyle aceptan AttachWriteGuardOwner, que vincula el objeto de regla a su libro de trabajo propietario para que las ediciones adquieran un write guard automáticamente; el propietario implementa TXLSCondFormatWriteGuardOwner, cuyo único método AcquireWriteGuard entrega a la regla el write guard del libro de trabajo. TXLSDxfStyle agrega FontColorIndex con FontColorIsIndexed más los pares FillFgColorIndex / FillFgColorIsIndexed y FillBgColorIndex / FillBgColorIsIndexed para colores de reglas por índice de paleta, y las invalidaciones de fuente diferencial FontName, FontSize y 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 write guard y marca la regla como dirty para su re-emisión

TXLSConnections, TXLSDataTables y TXLSQueryTables exponen OnAcquireWriteGuard (tipos TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuard y TXLSQueryTableAcquireWriteGuard), el hook que sus rutas de edición usan para obtener el IXLSWorkbookWriteGuard del libro de trabajo propietario antes de mutar y para avanzar la generación del libro después; el guard registra StartGeneration, y Complete marca la escritura como terminada para que las cachés dependientes puedan reconstruirse

Las conexiones de datos preservadas llevan una descripción con tipos: 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 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 pueden renderizarse o validarse programáticamente: XLSCfIconSetCount informa cuántos iconos define un TXLSIconSetType, y XLSBuildCfIconGeometry rellena un TXLSCfIconGeometry con las primitivas (TXLSCfIconPrimitive, tipo TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) y puntos (TXLSCfIconPoint) que dibujan un icono, para que los renderizadores personalizados igualen las formas de iconos 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 1 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 comienza la comprobación en la fila siguiente y tiene precedencia sobre FirstRow; de lo 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 tipo de valor, rango, longitud y patrón omiten los valores faltantes, los nulls y las cadenas vacías, mientras que irRequired los reporta; la unicidad conserva las políticas diferenciadas descritas abajo; los espacios en blanco no vacíos siguen siendo un valor; un número no califica como Boolean, una fecha no califica como número ordinario, y una cadena con apariencia numérica sigue siendo texto

Asignar MinimumValue o MaximumValue habilita ese límite; cualquiera de HasMinimum o HasMaximum puede deshabilitarlo de nuevo; ambos interruptores 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; límites invertidos, faltantes, incompatibles o vacíos lanzan una excepción antes de que comience 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 a entero preservan 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 IsMatch existente, así que use anclas como ^...$ cuando el texto completo deba coincidir; una regex inválida deshabilita 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 incluso cuando su formato numérico muestra una fecha; elija un modo de serial explícitamente cuando ese sea el esquema de importación aceptado; el modo afecta solo 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 de 10000; los seriales fraccionarios retienen su hora del día; el sistema 1900 rechaza todo serial desde 60 inclusive hasta 61 exclusivo porque ese intervalo denota el día bisiesto ficticio; el sistema 1904 mapea el serial cero al 1 de enero de 1904

Los límites de fecha incluyen la hora del día, así que un máximo fijado a la 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 el día final completo deba aceptarse; 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 retienen 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 y minúsculas, normalización Unicode, análisis por configuración regional ni ambigüedad de delimitadores; combinaciones como ('ab', 'c') y ('a', 'bc') siguen siendo diferentes; cada pasada de validación comienza un índice de tuplas fresco

Cuando SkipIncompleteRows = True, un miembro faltante, null o de cadena vacía excluye esa fila de la unicidad de tuplas; asignarle False incluye esos miembros con sus identidades Variant originales; un duplicado informa la primera columna de la tupla como su dirección de celda y la primera fila coincidente mediante FirstDuplicateRow

El irUnique existente de una sola columna conserva su comportamiento de coincidencia textual sin distinción de mayúsculas y minúsculas y omite los valores faltantes o null; use AddUniqueRule([Column]) cuando se exija identidad tipada estricta para una columna

Las comparaciones entre columnas nunca coercitan cadenas a números, números a Boolean ni números ordinarios a fechas; las categorías mixtas incompatibles fallan incluso para icNotEqual; las comparaciones de cadenas distinguen Unicode compuesto y descompuesto, preservan caracteres null incrustados y usan el orden de prefijo-más-corto-primero; cuando SkipBlankValues = False, cualquiera de los dos operandos en blanco produce una violación entre columnas

Resultados estructurados y libros de corrección

Check(Sheet) devuelve el número de violaciones, y ViolationCount más Violation(Index) de base 0 enumeran el reporte; una regla de columna informa su primer predicado que falla, mientras que las reglas de tupla y de comparación configuradas independientemente pueden agregar más violaciones para la misma celda; asigne valores Name con significado cuando los llamadores necesiten identificadores estables de reglas de la aplicación

Las celdas con 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 requieran resultados de fórmulas frescos; la validación no accede a fuentes externas, altera definiciones de fórmulas ni evalúa fórmulas sin caché

OnVerifyCell retiene la firma del callback TlxImportVerifyCell y se ejecuta después de los predicados de columna aplicables exitosos y de las comprobaciones de unicidad; devuelve un Boolean y puede asignar un mensaje de error de la aplicación; los callbacks deben mantener el libro y el esquema de validación sin cambios, y las escrituras al libro son rechazadas por el lease de lectura; las excepciones del callback se propagan y el lease se libera para operaciones posteriores

Check nunca anota, elimina 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 violaciones y crear un libro de corrección; estos métodos modifican la hoja de cálculo suministrada, así que llámelos sobre el libro previsto después de revisar el reporte

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 relevantes de celdas almacenadas y el acceso a cachés de fórmulas almacenadas durante toda la comprobación

Políticas 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 pistas del libro de trabajo

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;
      

Fórmulas de tabla y estado 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 Web Add-in

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 visualización de objetos del libro de trabajo

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 en 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 minúsculas, y cambiar solo el orden de las hojas no produce una diferencia

El valor Options predeterminado está vacío y ambas tolerancias son cero por defecto; la comparación predeterminada reporta hojas agregadas o eliminadas, celdas almacenadas agregadas o eliminadas, valores literales tipados cambiados, texto de fórmulas cambiado y rangos combinados agregados 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 escritura textual, las fechas retienen su propio tipo, y los errores se comparan por su código de error almacenado; los tipos de almacenamiento numérico con valores iguales se comparan como iguales, mientras que valores Int64 distintos permanecen distintos durante la comparación exacta

Options es de tipo TlxCompareOptions, un conjunto de TlxCompareOption; habilitar una opción agrega 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 preservan la misma validación atómica

Los presupuestos de características cubren los bytes canónicos separados agregados y las entradas contadas de ambos libros, incluidos runs de texto enriquecido, nodos XML de filtros, campos Pivot, miembros de dominio y valores de registros, y conexiones de slicers o timelines; los readers comprueban conteos y entradas de texto grandes antes de construir XML nativo, aplican flujos de salida acotados, y lanzan EXLSXSemanticBudget cuando se excede 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 AbsoluteTolerance y RelativeTolerance usan la misma validación

Los literales numéricos y los valores numéricos en caché se comparan como iguales 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 desborde para valores opuestos extremos, y la tolerancia no coercita texto ni se aplica a fechas, estilos ni geometría

LeftName y RightName fijan nombres de visualización opcionales usados por las líneas de Report, con left y right por defecto; los nombres afectan solo al reporte, 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 conteo de diferencias, Count lee ese conteo después, y Diff(Index) usa indexación de base 0 para devolver un TlxCompareDiff propiedad del comparador; retenga el comparador mientras lee sus entradas, y vuelva a obtener las entradas tras otra comparación exitosa

Cada entrada proporciona Kind, Sheet, Row y Col de base 1 donde aplica, Ref, LeftText, RightText y valores tipados LeftKind / RightKind; TlxCompareValueKind contiene lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvError y lcvFormula, con lcvNone usado para un lado ausente o una diferencia que no es de valor

TlxCompareKind retiene lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAdded y lckMergeRemoved, y agrega lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChanged y lckColumnGeometryChanged

Las diferencias de estilo llevan huellas canónicas estables de estilo en LeftText y RightText; las diferencias de geometría llevan el tamaño, oculto, esquema y estado de contraído 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 características usan lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged o lckTimelineChanged; Change es lccChanged, lccAdded o lccRemoved, y cada lado presente lleva su huella canónica de definición mientras que un lado ausente lleva una cadena vacía

lckRichTextChanged identifica una definición de run cambiada en su coordenada de celda y lleva huellas canónicas de runs en LeftText y RightText; la tolerancia numérica se aplica a literales de celda y cachés de fórmulas, mientras que las definiciones tipadas de características se comparan exactamente

Las referencias de características identifican nombres con ámbito o nombres de tablas, o usan posiciones de secuencia de base 1 para definiciones de validación, formato condicional y dibujos; insertar o mover una característica ordenada puede cambiar varias posiciones, mientras que las entradas de nombres a nivel de libro tienen un Sheet vacío

lckBlankStyleRegionChanged identifica un rectángulo en blanco cambiado mediante Row, Col, LastRow y LastCol inclusivos, y su Ref en A1; las coordenadas almacenadas las maneja la comparación ordinaria de celdas y lcoCellStyles, así que habilite 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 en lugar del orden de inserción de celdas

La comparación mantiene leases de lectura, recorre las celdas almacenadas a través de instantáneas de cursores separadas, y retiene 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 rectángulos activos y los límites de celdas almacenadas sin escanear una cuadrícula rectangular de un millón de filas; el trabajo crece con las características almacenadas, las intersecciones de regiones y las diferencias reportadas

Una comparación fallida preserva el resultado exitoso previo; una asignación de tolerancia inválida también preserva los ajustes y el resultado existentes, mientras que pasar un libro nil limpia el resultado y devuelve cero

Esta comparación cubre el contenido de celdas almacenadas de la fachada XLSX y definiciones tipadas seleccionadas de características; la escritura de fórmulas de nombres, validaciones, formatos condicionales, tablas y gráficos se normaliza a través del parser semántico de fórmulas, mientras que las fórmulas calculadas de Pivot retienen su texto de definición almacenado

Los filtros de tablas aceptan formas y condiciones de ordenación soportadas personalizadas, de lista de valores, de grupos de fechas, de color, de iconos, dinámicas y de top-count; las columnas de filtro independientes y las entradas de conjuntos de valores normalizan su orden, los valores predeterminados Boolean y las escrituras 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 fuentes locales de hojas de cálculo soportadas y vinculaciones no OLAP sin refrescar ni evaluar disponibilidad; las pistas nativas de disponibilidad de slicers son metadatos de visualización derivados, mientras que las selecciones de miembros y los metadatos nativos de ordenación reconocidos se comparan

Las propiedades nativas opacas de dibujos, los modelos Pivot binarios incompletos, las fuentes Pivot externas u OLAP, los registros suplementarios crudos de PivotTable y el XML de extensiones, el XML de filtros desconocido, y los atributos o hijos de extensión de slicers o timelines sin modelar lanzan EXLSSemanticSnapshot; la preservación de tales datos no implica equivalencia semántica

Las características importadas seleccionadas de PivotTable y PivotCache también validan el XML nativo preservado antes de comparar la proyección tipada, incluidos los metadatos de campos anidados 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 características, mientras que las vinculaciones modeladas de cachés de slicers siguen soportadas

TSimpleDomNode.RawName expone el QName original del elemento junto al Name normalizado por el reader, permitiendo inspección sensible a namespaces sin cambiar la coincidencia de nombres existente del parser

Los ajustes del libro y los metadatos opacos del paquete permanecen 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 soportados de imágenes, cuadros de texto, gráficos 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 ordenado, mientras que TMsoFbtSp.PersistentFlags expone los flags nativos de la forma sin asignar propiedades ni anclajes

TMsoShapeContainer.HasPreservedObjectData identifica los bytes de cola OBJ retenidos; HasOrdinaryEmbeddedPictureObjectData comprueba que las colas de imágenes contengan solo formatos de portapapeles reconocidos y registros de flags de imagen en cero, y rechaza los registros vinculados 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 datos nativos de dibujo que el parser tipado omite, permitiendo que la captura rechace explícitamente una apariencia sin resolver

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSet y ColorSet distinguen las propiedades de fuente heredadas de las anulaciones explícitas, incluidos los flags falsos, none, baseline y los colores automáticos; los setters marcan la propiedad como explícita incluso cuando su valor coincide con el valor inicial predeterminado del nuevo run

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 explícitamente esos runs, mientras que las propiedades compartidas/en línea de runs soportadas y los espacios en blanco retienen su semántica importada

La comparación efectiva de texto enriquecido aplica las anulaciones explícitas en falso antes de fusionar runs adyacentes iguales; las propiedades heredadas y las limpiadas explícitamente permanecen distintas durante la deduplicación de cadenas compartidas y los round trips XML soportados

TXMLReader.ResolveNamespaceUri(Prefix, Uri) resuelve la vinculación de namespace actualmente en alcance sin cambiar la posición del reader, devolviendo false cuando no existe vinculación; un prefijo vacío solicita el namespace predeterminado, y los QNames crudos siguen disponibles para 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 headless portable

Inspección separada de estilos y ejes

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) devuelve un TXLSSemanticCellStyle separado para coordenadas válidas de base 1, resolviendo estilos almacenados y empaquetados, valores predeterminados de la 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 estilos de tabla

TXLSXWorksheet.GetStoredAxisSpans(IsRow) devuelve TXLSXAxisSpans, un arreglo de registros TXLSXAxisSpan con FirstIndex y LastIndex inclusivos de base 1; reporta las huellas de metadatos de tamaño, oculto, esquema y contraído, preserva los tramos compactos de altos de filas repetidas, y deja el 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, y luego inspeccionar el estado efectivo una vez por cada intervalo resultante

TXLSXWorksheet.GetStoredStyleRegions devuelve TXLSXStyleRegions separados que contienen los límites inclusivos FirstRow, FirstCol, LastRow y LastCol de las huellas compactas de formato virtual; estas huellas pueden solaparse, y los llamadores leen su apariencia efectiva con ReadSemanticCellStyle

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

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

Los nombres definidos y los tres tipos de cachés 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 retienen su secuencia almacenada, y los arreglos y búferes devueltos son copias propiedad del llamador; estos readers adquieren leases de lectura y heredan la cobertura tipada y el comportamiento explícito con datos no soportados descrito arriba

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

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

Metadatos de fórmulas y callbacks de consultas Pivot

TXLSGetCellFormulaText y TXLSCalculator.OnGetCellFormulaText leen el texto de expresiones almacenado usando un SheetIndex de base 1 y Row/Col de base 0, devolviendo lxOk o un código de error tipado y respetando la protección formula-hidden; TXLSGetPivotTable y OnGetPivotTable localizan una tabla prestada usando un SheetIndex de base 1 y coordenadas de rango de base 0

Los motores de libros conectan estos callbacks opcionales en contextos de cálculo normal, de solo lectura y aislado; los callbacks no recalculan destinos, no refrescan fuentes Pivot ni transfieren propiedad

TXLSPivotDataConstraint almacena un FieldName y un Item tipado, con TXLSPivotDataConstraints coleccionando pares campo/item; TXLSPivotTable.GetDataValue consulta un agregado visible soportado desde una instantánea separada de tabla/caché local, e IntersectsQueryRange usa límites de hoja de base 1 incluidas las celdas modeladas de filtros de reporte

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

TXLSPivotCache.QueryModelIsComplete registra la preparación de consultas decodificada independientemente de la completitud de la reproducción cruda BIFF; QueryRecordsValid expone la validez de los registros importados y SetQueryRecordValidity aplica la precedencia del form-reader sin refrescar registros

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

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 matriz

Pools clásicos de fuentes, formatos y estilos

Aplicaciones auxiliares de paquete y almacenamiento binario

Novedades de dibujo y del visor de libros de trabajo

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

Modelos de gráfico clásicos y objetos de gráfico de la hoja de cálculo

Modelo de decodificación de gráficos con tipos

El estado decodificado del gráfico se expone como registros y enums sencillos para que el código de inspección nunca tenga que recorrer registros BIFF crudos: TXLSChartInfo lleva el resumen decodificado del gráfico con TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), cada serie informa su TXLSChartSeriesType, y TXLSChart3DState más 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 barras de error son objetos con tipos (TXLSChartTrendline, TXLSChartErrorBars) alcanzables desde cada serie

Registros de autoría de gráficos

La autoría de hojas de gráfico y del constructor acepta registros sencillos en lugar de grafos de objetos: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfo y TXLSChartSeriesStyleInfo rellenan las entradas de serie que se pasan a TXLSWorksheets.AddChartSheet y al constructor de gráficos compartido, y TXLSPivotChartInfo describe el enmarcado de gráfico dinámico usado cuando un gráfico se adjunta a una tabla dinámica

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

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

La inspección de gráficos valida la carga útil completa almacenada de texto y anotaciones antes de agregar estado tipado: los nombres de líneas de tendencia truncados o los separadores de etiquetas de datos reportan su ID de registro a través de _UnsupportedSemanticRecordID, mientras que los encabezados SeriesText nil o de tamaño insuficiente reportan ese registro como no soportado tanto para BIFF5 como para BIFF8; una extensión declarada de texto de serie que excede su carga útil lanza EReadError, libera el modelo parcial y deja los registros almacenados del gráfico sin cambios

El getter de marcadores y la inspección de rellenos preservan el almacenamiento crudo del gráfico; la ruta de captura de apariencia declarada valida por separado los gráficos de núcleo soportados, mientras que las sumas de verificación no verificadas de extensiones de títulos enriquecidos o de formas siguen sin soportarse

Readers acotados de gráficos, cadenas y fuentes almacenadas

TXLSChartStoredBytes es un arreglo de bytes separado y TXLSChartStoredRecord contiene RecordId y Data; estos readers 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 en lxStringTable respalda las cadenas compartidas del libro Classic; los miembros de abajo cubren el registro del lado del reader, el mantenimiento de ranuras y la emisión cruda de SST para guardados de round trip

Adjuntos PDF, firmas y exportación HTML

Auditoría de cálculo y controles del libro de trabajo

Compatibilidad con el encuadre heredado de PivotCache

StreamId se escribe como el registro SXStreamID ([MS-XLS] §2.4.303) y se repite como el campo idstm del encabezado SXDB, que debe coincidir con él; SourceDataType se escribe como el registro SXVS ([MS-XLS] §2.4.317: $0001 hoja de cálculo, $0002 externa, $0004 consolidación, $0010 escenario) y se repite como el campo vsType del encabezado SXDB, que debe coincidir con él. Las cachés construidas desde un rango de hoja de cálculo empiezan con el tipo hoja de cálculo, mientras que las cachés leídas de un archivo conservan el valor que traía su subflujo, de modo que el escritor BIFF nunca deja un campo SXDB nombrando un registro que no emitió; RawHasStorageStream marca una caché cargada desde su propio flujo de almacenamiento cuyo descriptor global del libro de trabajo 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);
      

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

Ver también

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