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 libro, hoja de cálculo, rango, estilo, filtro y gráfico
Paneles, visualización y fondo de la hoja de cálculo
TXLSXWorksheet.SplitPanes y RemoveSplit editan el estado de paneles divididos; SplitRow, SplitCol, PaneStateKindy ScrollCol exponen las coordenadas de vista almacenadas
DisplayRowColHeaders controla los encabezados de fila y columna, 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 de solo lectura neutral respecto al backend con su descripción de formato, y ClearBackgroundImage la elimina
Selecciones de paneles y desplazamiento
GetSelectedAreas y la sobrecarga de SelectAreas que prioriza paneles usan el tipo compartido TXLSPanePosition , conservan áreas A1 ordenadas y solapadas, y devuelven instantáneas propiedad del llamador con el índice del área activa
Las ediciones estructurales de filas y columnas completas remapean cada selección de panel, conservan el orden superviviente y la identidad del área activa, y usan sustitutos deterministas de celda sucesora, predecesora o de frontera cuando el área activa se elimina
La normalización de selecciones, el remapeo estructural y la construcción de instantáneas usan constructores de una pasada y crecimiento geométrico de capacidad para procesar grandes áreas en tiempo lineal amortizado
TryGetWindowScroll y ScrollWindow usan los mismos paneles lógicos y coordenadas basadas en uno mientras retienen de forma independiente las posiciones de desplazamiento generales de sheetView y del pane inferior o derecho
Los paneles ausentes y las actualizaciones no válidas dejan la hoja de cálculo sin cambios; vea Selecciones y desplazamiento de paneles de hoja
Rangos de mantenimiento conjunto en paginación
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogethery KeepTogetherCount definen bloques que deben permanecer en una página cuando la geometría lo permite
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRowy KeepColBlockBreakCol inspeccionan cómo interactúan los saltos de página propuestos con esos bloques
Asistentes de edición de hoja de cálculo
AddImagePair escribe una imagen principal más un acompañante de reserva como SVG y PNG, AddChartFromRanges construye un gráfico a partir de rangos de categoría y valor tipados, y CheckDataValidations devuelve cada celda infractora
CheckDataValidation comprueba un valor candidato contra cada regla de validación que cubre una celda, devuelve -1 cuando es válido o el índice basado en uno 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 cambios en una columna e inserta fórmulas de subtotal, fórmulas opcionales de total general, formato heredado y niveles de esquema
SortRangeInternal es el punto de entrada de ordenación estable avanzada usado por las operaciones de rango e informe; 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 comprobaciones HasColWidth / HasRowHeight probes
Control de nodos de esquema
TryGetOutlineNode devuelve el nodo de resumen consciente de la dirección, el rango de detalle, el nivel de esquema, el estado oculto y el marcador explícito de contraer para un índice de fila o columna basado en uno
SetOutlineNodeCollapsed contrae o expande de forma idempotente un nodo de resumen, mientras que SetOutlineDisplayLevel aplica el nivel de botón de esquema basado en uno en todos los grupos materializados; ambos aceptan el manejo de hijos xocPreserve, xocCollapseo xocExpand child handling
ToggleRowGrouped y ToggleColGrouped siguen siendo envoltorios de compatibilidad que aceptan el primer índice de detalle y resuelven el nodo de resumen real a partir de 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 estructura, y se convierten a marcadores de nodos de resumen XLSX sin retener indicadores de contracción a nivel de miembro; vea 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 de número, alineación o protección
Editar TXLSXNamedStyle.Style actualiza las partes vinculadas sin descartar las invalidaciones 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 mostrado sin examinar la colección manualmente
Los 60 nombres de estilos de tabla integrados claros, medios y oscuros se resuelven a formatos completos de sección basados en el tema, 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; vea 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 tipadas compatibles por filas, y PackedCellCount informa de las celdas retenidas allí antes de que el acceso a nivel de objeto materialice identificadores estables de celda
GetStorageStatistics informa de bloques de filas, filas pobladas, recuentos de bytes de objetos, texto, fórmulas, texto enriquecido, estimado empaquetado, empaquetado activo, asignado, usado y cadenas empaquetadas para decisiones de memoria medibles; los recuentos de cargas de estilo y los bytes de carga de celdas en blanco con estilo evitados exponen directamente el uso compartido copy-on-write
Detalles de autofiltro
TXLSXAutoFilterColumn.ClearValueFilters borra los filtros de valor y de grupo de fechas conservando la entrada de columna
HasCriteria2 y AndConnector describen filtros personalizados de dos condiciones; los filtros de color usan HasColorFilter, HasColorFilter_CellColory HasColorFilter_DxfId; los filtros de icono usan HasIconFilter, HasIconFilter_Sety HasIconFilter_Id
Los filtros dinámicos usan HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxValy HasDynamicFilter_MaxValSet; RawXml conserva la carga de filtro no compatible
Rellenos degradados
TXLSXFill.AddGradientStop añade una parada de color. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCounty GradientStops exponen la geometría lineal o de trazo
BackgroundColorTheme, BackgroundColorIndexy BackgroundTintAndShade conservan colores de fondo no RGB, y TXLSXFills.AddLinearGradient crea y registra un degradado lineal completo
TXLSXFill.ForegroundColorTheme, ForegroundColorIndex, and ForegroundTintAndShade son las contrapartes de primer plano: conservan, junto al valor RGB, los colores de primer plano de tema, de índice de paleta y de matiz y sombra
Gráficos
TXLSXChart expone PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnlyy la fachada de compatibilidad DataLabelsRange , cuyo setter difunde a las series actuales y preconfigura las series posteriores, mientras que su getter devuelve solo una fórmula común por serie
TXLSXChartPlotGroup.Assign copia un grupo de trazado; ZOrder, BarGrouping, GapWidthy Overlap controlan su orden y la geometría de las barras
TXLSXChartSeries expone SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPosy LabelPosSet
Las etiquetas por serie procedentes de celdas usan DataLabelsRange, DataLabelsCache, ShowDataLabelsRangey ShowDataLabelsRangeSet; SetPointShowDataLabelsRange y TryGetPointShowDataLabelsRange mantienen invalidaciones dispersas de visibilidad basadas en cero, mientras que ResolveDataLabelsRange actualiza el texto accesible de la hoja de cálculo una vez por generación del libro y retiene cachés externas sin abrir un origen de datos
TXLSXChartSeries.CategoriesMultiLevel emite categorías c:multiLvlStrRef para etiquetas de eje jerárquicas, mientras que el comportamiento predeterminado mantiene la emisión plana c:strRef / c:numRef emission
TXLSXChartTrendline expone los periodos de previsión Intercept, InterceptSet, Forwardy Backward , 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 de un estilo diferencial y StdDev, EqualAveragee IsPivot exponen indicadores de regla avanzados
TXLSXConditionalFormat.AcquireWriteGuard realiza la comprobación equivalente de pertenencia al rango de validación indexado IXLSWorkbookWriteGuard para que las ediciones de reglas por lotes hagan avanzar la generación del libro una sola vez al completarse
TXLSXDataValidation.ContainsCellFast del libro para que las ediciones de reglas por lotes avancen la generación del libro una sola vez al completarse
Tablas, hojas, vínculos, comentarios y dibujos
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIdsy HasHeaderRow conservan metadatos de tabla respaldada por consulta y sin encabezado
TXLSXTable.FindFirst y FindNext examinan una hoja de cálculo suministrada por el llamador en busca de filas cuya columna con nombre sea igual a un valor, devolviendo una fila basada en uno o 0, con comparaciones de cadena, numéricas y booleanas que no distinguen mayúsculas de minúsculas
TXLSXSheets.AddCopy duplica una hoja de cálculo con objetos dependientes y ByPos accede a la colección por la posición actual de la pestaña
TXLSXExternalLink.AddDefinedName y DefinedNameCount mantienen nombres externos cacheados y FindDefinedName localiza una entrada por nombre; las propiedades de solo lectura RelationshipId, SourceSloty LinkKind exponen el identificador de relación de la parte de vínculo externo, la ranura [N] basada en uno que usan las fórmulas externas y la clasificación del vínculo (libro, DDE, OLE o desconocido); TXLSXHyperlink.TargetFrame conserva el contexto de navegación de destino
TXLSXDefinedName.UnknownAttributes conserva los atributos no reconocidos de un nombre definido para que las extensiones no soportadas sobrevivan a los round-trips
TXLSXComment.AutoSizeFromText ajusta la forma del comentario a su texto y ClearFont elimina las ejecuciones de fuente de texto enriquecido explícitas
TXLSXImage.SvgData almacena el acompañante SVG y CameraRange identifica un rango de origen de imagen vinculada; TXLSXTextBox.PrstToken conserva el token de geometría preestablecida DrawingML
Las imágenes comparten cargas sin copiar bytes: asignar TXLSXImage.Blob (la interfaz IXLSXImageBlob con Data, SvgData, CacheKey, ContentDigest, SvgContentDigesty ByteSize) es la ruta de copia cero para imágenes de informe repetidas, los resúmenes se calculan una vez para la internación de medios al guardar, y los TXLSXImage.CacheKey y ContentDigest de solo lectura informan de la identidad asignada; la caché de informes rechaza una clave de caché reutilizada con bytes o formatos distintos
DrawingObjectCount y DrawingObject exponen un orden mixto estable entre imágenes, gráficos, cuadros de texto, anclajes sin procesar preservados y grupos; cada TXLSXDrawingObject expone Kind, Parent, ChildCounty TextBox, y puede reordenarse con BringToFront, SendToBack, BringForwardy SendBackward
GroupDrawingObjects crea un grupo DrawingML consciente de las 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 hoja de cálculo
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImagey BackgroundImageResource crean, eliminan e inspeccionan fondos de hoja de cálculo BIFF8; los datos de mapa de bits se exponen como un BMP estándar, los formatos nativos o desconocidos retienen su carga y código de formato sin procesar, y los fondos conocidos se convierten en ambas direcciones entre los motores Classic y XLSX
TXLSWorksheet.ConvertFormulasToValues reemplaza fórmulas por resultados en caché, las sobrecargas de OpenRTF importan una tabla RTF en el destino predeterminado o elegido por el llamador, WriteAutoValue selecciona un tipo de celda a partir de una variante y DefaultFormat expone el XF predeterminado de la hoja de cálculo