Miembros avanzados de la API XLSX
Estos miembros cubren superficies de edición XLSX públicas menos comunes que complementan las páginas de referencia principales de libros de trabajo, hojas de cálculo, rangos, estilos, filtros y gráficos
Paneles, visualización y fondo de la hoja de cálculo
TXLSXWorksheet.SplitPanes y RemoveSplit editan el estado de paneles divididos; SplitRow, SplitCol, PaneStateKind y ScrollCol exponen las coordenadas de vista almacenadas
DisplayRowColHeaders controla los encabezados de filas y columnas, GridLinesSet distingue una elección explícita de líneas de cuadrícula del valor predeterminado, y DefaultFormat más StyleOverlays exponen el estado de estilo a nivel de hoja
BackgroundImageData y BackgroundImageFormat exponen la imagen de fondo de la hoja de cálculo, BackgroundImageResource proporciona una carga útil de solo lectura independiente del backend con su descripción de formato, y ClearBackgroundImage la elimina
Selecciones por panel y desplazamiento
GetSelectedAreas y la sobrecarga de SelectAreas con prioridad de panel usan el tipo compartido TXLSPanePosition, preservan áreas A1 ordenadas y superpuestas, y devuelven instantáneas propiedad del llamador con el índice del área activa
Las ediciones estructurales de filas y columnas completas remapean todas las selecciones de paneles, preservan el orden de las que sobreviven y la identidad del área activa, y usan sucesores, predecesores o celdas de borde deterministas cuando se elimina el área activa
La normalización de selecciones, el remapeo estructural y la construcción de instantáneas usan constructores de una sola pasada y crecimiento geométrico de capacidad para procesar áreas grandes en tiempo amortizado lineal
TryGetWindowScroll y ScrollWindow usan los mismos paneles lógicos y coordenadas de base 1, reteniendo de forma independiente las posiciones de desplazamiento generales de sheetView y las del pane inferior o derecho
Los paneles ausentes y las actualizaciones no válidas dejan la hoja de cálculo sin cambios; consulte Selecciones y desplazamiento de paneles de hoja de cálculo
Rangos de agrupación en paginación
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether y KeepTogetherCount definen bloques que deben permanecer en una sola página cuando la geometría lo permite
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow y KeepColBlockBreakCol inspeccionan cómo interactúan los saltos de página propuestos con esos bloques
Asistentes de edición de hojas de cálculo
AddImagePair escribe una imagen principal más un acompañante de respaldo como SVG y PNG, AddChartFromRanges construye un gráfico a partir de rangos de categorías y valores con tipos, y CheckDataValidations devuelve todas las celdas que infringen la validación
CheckDataValidation prueba un valor candidato contra todas las reglas de validación que cubren una celda, devuelve -1 cuando es válido o el índice de base 1 de la primera regla que falla, y opcionalmente confirma solo un candidato válido
GetCellVisibleFormat resuelve el formato efectivo de hoja de cálculo, fila, columna, superposición de rango y celda explícita sin crear una celda vacía; Subtotal agrupa un rango ordenado por los cambios de una columna e inserta fórmulas de subtotal, fórmulas de total general opcionales, formato heredado y niveles de esquema
SortRangeInternal es el punto de entrada avanzado de ordenación estable usado por las operaciones de rangos e informes; los llamadores normalmente deberían preferir SortRange o TXLSXRange.Sort
ClearColWidth y ClearRowHeight eliminan la dimensión explícita de una columna o fila para que vuelva al valor predeterminado de la hoja, complementando las sondas HasColWidth / HasRowHeight
Control de nodos de esquema
TryGetOutlineNode devuelve el nodo de resumen según la dirección, el rango de detalle, el nivel de esquema, el estado oculto y el marcador de colapso explícito para un índice de fila o columna de base 1
SetOutlineNodeCollapsed contrae o expande de forma idempotente un nodo de resumen, mientras que SetOutlineDisplayLevel aplica el nivel de botón de esquema de base 1 en todos los grupos materializados; ambos aceptan el manejo de hijos xocPreserve, xocCollapse o xocExpand
ToggleRowGrouped y ToggleColGrouped siguen siendo envoltorios de compatibilidad que aceptan el primer índice de detalle y resuelven el nodo de resumen real desde SummaryBelow o SummaryRight
Los grupos nativos de filas y columnas de OpenDocument se mapean a través de table:display, sobreviven a las ediciones directas de metadatos y estructurales, y se convierten a marcadores de nodos de resumen XLSX sin conservar flags de colapso a nivel de miembro; consulte Geometría de esquema dispersa
Estilos con nombre y resolución de estilos de tabla
TXLSXRange.ApplyNamedStyle vincula un rango a un estilo de celda con nombre; TXLSXLinkedStyle.AutomaticChoose deduce las partes de formato afectadas a partir del estilo, mientras que LinkedParts selecciona explícitamente fuente, relleno, borde, formato numérico, alineación o protección
Editar TXLSXNamedStyle.Style actualiza las partes vinculadas sin descartar las anulaciones locales, y GetCellVisibleFormat resuelve el resultado junto con las superposiciones de la hoja de cálculo y los estilos de tabla sin materializar celdas en blanco
TXLSXNamedStyles.FindByName localiza una entrada de estilo con nombre por su nombre para mostrar, sin escanear la colección manualmente
Los 60 nombres de estilos de tabla integrados light, medium y dark se resuelven en formatos de sección completos basados en temas, compartidos por las salidas HTML, PDF, imagen, vista previa y visor
Conversión de fórmulas
TXLSXCell.ConvertFormulaToValue reemplaza una fórmula por su valor en caché y TXLSXCells.ConvertFormulasToValues aplica la misma operación a la colección de celdas almacenada
Validación de entrada de fórmulas
TXLSXWorkbook.FormulaEntryPolicy y TXLSXWorksheet.ValidateFormulaEntry exponen el contrato compartido de entrada de fórmulas sin mutaciones, distinguen texto vacío, funciones desconocidas, nombres desconocidos, fallos de sintaxis y destinos no válidos, y reconocen las funciones de usuario registradas sin invocarlas; consulte Política de validación de entrada de fórmulas
Diagnósticos de almacenamiento de celdas
TXLSXCells.PackedStorageEnabled controla el backend RLE empaquetado que usan las escrituras masivas con tipos compatibles por filas, y PackedCellCount informa las celdas retenidas allí antes de que el acceso a nivel de objeto materialice manejadores de celda estables
GetStorageStatistics informa bloques de filas, filas pobladas, y conteos de bytes de objetos, texto, fórmulas, texto enriquecido, empaquetado estimado, empaquetado activo, asignado, usado y cadenas empaquetadas para tomar decisiones de memoria con datos medibles; los conteos de cargas útiles de estilo y los bytes de cargas útiles de blancos con estilo evitados exponen directamente el uso compartido copy-on-write
Detalles de AutoFiltro
TXLSXAutoFilterColumn.ClearValueFilters borra los filtros de valores y grupos de fechas conservando la entrada de la columna
HasCriteria2 y AndConnector describen filtros personalizados de dos condiciones; los filtros de color usan HasColorFilter, HasColorFilter_CellColor y HasColorFilter_DxfId; los filtros de iconos usan HasIconFilter, HasIconFilter_Set y HasIconFilter_Id
Los filtros dinámicos usan HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal y HasDynamicFilter_MaxValSet; RawXml preserva la carga útil de filtros no soportados
Rellenos de degradado
TXLSXFill.AddGradientStop agrega una parada de color. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount y GradientStops exponen la geometría lineal o de trazado
BackgroundColorTheme, BackgroundColorIndex y BackgroundTintAndShade preservan colores de fondo que no son RGB, y TXLSXFills.AddLinearGradient crea y registra un degradado lineal completo
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex y ForegroundTintAndShade son las contrapartes de primer plano, preservando colores de primer plano de tema, índice de paleta y tono/sombreado junto al valor RGB
Gráficos
TXLSXChart expone PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly y la fachada de compatibilidad DataLabelsRange, cuyo definidor difunde a las series actuales y preconfigura las series posteriores, mientras que su obtenedor devuelve solo una fórmula común por serie
TXLSXChartPlotGroup.Assign copia un grupo de trazado; ZOrder, BarGrouping, GapWidth y Overlap controlan su orden y geometría de barras
TXLSXChartSeries expone SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos y LabelPosSet
Las etiquetas por serie procedentes de celdas usan DataLabelsRange, DataLabelsCache, ShowDataLabelsRange y ShowDataLabelsRangeSet; SetPointShowDataLabelsRange y TryGetPointShowDataLabelsRange mantienen anulaciones dispersas de visibilidad de base 0, mientras que ResolveDataLabelsRange actualiza el texto accesible de la hoja de cálculo una vez por generación del libro de trabajo y conserva las cachés externas sin abrir un origen de datos
TXLSXChartSeries.CategoriesMultiLevel emite categorías c:multiLvlStrRef para etiquetas de ejes jerárquicas, mientras que el valor predeterminado mantiene la emisión plana c:strRef / c:numRef
TXLSXChartTrendline expone Intercept, InterceptSet, Forward y Backward como periodos de pronóstico, mientras que TXLSXChartAxis.ShowDispUnitsLabel controla la etiqueta de unidades de visualización
Formatos condicionales y validaciones
TXLSXConditionalFormat.ContainsCellFast realiza comprobaciones de pertenencia indexadas, HasStyle informa si hay un estilo diferencial, y StdDev, EqualAverage e IsPivot exponen flags avanzados de reglas
TXLSXConditionalFormat.AcquireWriteGuard devuelve el IXLSWorkbookWriteGuard del libro de trabajo para que las ediciones de reglas por lotes avancen la generación del libro de trabajo una sola vez al terminar
TXLSXDataValidation.ContainsCellFast realiza la comprobación indexada equivalente de pertenencia al rango de validación
Tablas, hojas, vínculos, comentarios y dibujos
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds y HasHeaderRow preservan los metadatos de tablas respaldadas por consultas y de tablas sin encabezado
TXLSXTable.FindFirst y FindNext escanean una hoja de cálculo proporcionada por el llamador buscando filas cuya columna con nombre sea igual a un valor, y devuelven una fila de base 1 o 0, con comparaciones de cadenas sin distinción de mayúsculas y minúsculas, numéricas y booleanas
TXLSXSheets.AddCopy duplica una hoja de cálculo con sus objetos dependientes y ByPos accede a la colección por posición de pestaña actual
TXLSXExternalLink.AddDefinedName y DefinedNameCount mantienen nombres externos en caché y FindDefinedName localiza una entrada por nombre; las propiedades de solo lectura RelationshipId, SourceSlot y LinkKind exponen el id de relación de la parte de vínculo externo, la ranura [N] de base 1 que usan las fórmulas externas y la clasificación del vínculo (libro de trabajo, DDE, OLE o desconocido); TXLSXHyperlink.TargetFrame preserva el contexto de exploración del destino
TXLSXDefinedName.UnknownAttributes preserva los atributos no reconocidos de un nombre definido para que las extensiones no soportadas sobrevivan a los round-trip
TXLSXComment.AutoSizeFromText ajusta el tamaño de la forma del comentario a su texto y ClearFont elimina los tramos de fuente de texto enriquecido explícitos
TXLSXImage.SvgData almacena el acompañante SVG y CameraRange identifica el rango de origen de una imagen vinculada; TXLSXTextBox.PrstToken preserva el token de geometría preestablecida de DrawingML
Las imágenes comparten cargas útiles sin copiar bytes: asignar TXLSXImage.Blob (la interfaz IXLSXImageBlob con Data, SvgData, CacheKey, ContentDigest, SvgContentDigest y ByteSize) es la ruta de copia cero para imágenes de informes repetidas, los resúmenes se calculan una vez para la internación de medios al guardar, y TXLSXImage.CacheKey y ContentDigest, de solo lectura, informan la identidad asignada; la caché de informes rechaza una clave de caché reutilizada con bytes o formatos distintos
DrawingObjectCount y DrawingObject exponen un único orden mixto estable entre imágenes, gráficos, cuadros de texto, anclas crudas preservadas y grupos; cada TXLSXDrawingObject expone Kind, Parent, ChildCount y TextBox, y puede reordenarse con BringToFront, SendToBack, BringForward y SendBackward
GroupDrawingObjects crea un grupo DrawingML consciente de transformaciones a partir de los objetos seleccionados y UngroupDrawingObject restaura sus hijos en orden, incluidos los grupos cargados de un paquete existente
Contrapartes clásicas de hojas de cálculo
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage y BackgroundImageResource crean, eliminan e inspeccionan fondos de hoja de cálculo BIFF8; los datos de mapa de bits se exponen como BMP estándar, los formatos nativos o desconocidos conservan su carga útil cruda y su código de formato, y los fondos conocidos se convierten en ambas direcciones entre los motores Classic y XLSX
TXLSWorksheet.ConvertFormulasToValues reemplaza las fórmulas por sus resultados en caché, las sobrecargas de OpenRTF importan una tabla RTF en el destino predeterminado o elegido por el llamador, WriteAutoValue selecciona el tipo de celda a partir de una variante, y DefaultFormat expone el XF predeterminado de la hoja de cálculo