Membros avançados da API XLSX
Estes membros cobrem superfícies de edição XLSX públicas mas menos comuns, que complementam as páginas de referência principais de livro de trabalho, folha de cálculo, intervalo, estilo, filtro e gráfico
Painéis, apresentação e fundo da folha de cálculo
TXLSXWorksheet.SplitPanes e RemoveSplit editam o estado dos painéis divididos; SplitRow, SplitCol, PaneStateKind e ScrollCol expõem as coordenadas de vista armazenadas
DisplayRowColHeaders controla os cabeçalhos de linhas e colunas, GridLinesSet distingue uma escolha explícita de linhas de grelha do valor predefinido, e DefaultFormat mais StyleOverlays expõem o estado de estilo ao nível da folha
BackgroundImageData e BackgroundImageFormat expõem a imagem de fundo da folha de cálculo, enquanto ClearBackgroundImage a remove
Seleções de painéis e deslocamento
GetSelectedAreas e a sobrecarga SelectAreas centrada nos painéis usam o tipo partilhado TXLSPanePosition, preservam áreas A1 ordenadas e sobrepostas e devolvem instantâneos pertencentes ao chamador com o índice da área ativa
As edições estruturais de linhas e colunas inteiras remapeiam todas as seleções de painéis, preservam a ordem sobrevivente e a identidade da área ativa, e usam fallbacks determinísticos de sucessor, predecessor ou célula de limite quando a área ativa é removida
A normalização de seleções, o remapeamento estrutural e a construção de instantâneos usam builders de uma única passagem e crescimento geométrico de capacidade para processamento amortizado-linear de áreas grandes
TryGetWindowScroll e ScrollWindow usam os mesmos painéis lógicos e coordenadas de base 1, mantendo independentemente as posições de deslocamento globais de sheetView e do pane inferior ou direito
Painéis em falta e atualizações inválidas deixam a folha de cálculo inalterada; veja Seleções de painéis e deslocamento da folha de cálculo
Intervalos de manter-junto na paginação
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether e KeepTogetherCount definem blocos que devem permanecer numa página onde a geometria o permita
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow e KeepColBlockBreakCol inspecionam como as quebras de página propostas interagem com esses blocos
Auxiliares de edição da folha de cálculo
AddImagePair escreve uma imagem primária mais um acompanhante de fallback, como SVG e PNG, AddChartFromRanges constrói um gráfico a partir de intervalos tipados de categorias e valores, e CheckDataValidations devolve todas as células em violação
SortRangeInternal é o ponto de entrada avançado de ordenação estável utilizado pelas operações de intervalo e relatório; os chamadores devem normalmente preferir SortRange ou TXLSXRange.Sort
Controlo de nós de estrutura de tópicos
TryGetOutlineNode devolve o nó de resumo com noção de direção, o intervalo de detalhe, o nível de estrutura de tópicos, o estado oculto e o marcador de colapso explícito para um índice de linha ou coluna de base 1
SetOutlineNodeCollapsed colapsa ou expande de forma idempotente um nó de resumo, enquanto SetOutlineDisplayLevel aplica o nível de botão de estrutura de tópicos de base 1 em todos os grupos materializados; ambos aceitam o tratamento de filhos xocPreserve, xocCollapse ou xocExpand
ToggleRowGrouped e ToggleColGrouped mantêm-se como wrappers de compatibilidade que aceitam o primeiro índice de detalhe e resolvem o nó de resumo real a partir de SummaryBelow ou SummaryRight
Os grupos nativos de linhas e colunas do OpenDocument mapeiam através de table:display, sobrevivem a edições diretas de metadados e estruturais e convertem-se em marcadores de nós de resumo XLSX sem reter sinalizadores de colapso ao nível de membro; veja Geometria esparsa de estruturas de tópicos
Estilos nomeados e resolução de estilos de tabela
TXLSXRange.ApplyNamedStyle liga um intervalo a um estilo de célula nomeado; TXLSXLinkedStyle.AutomaticChoose deduz as partes de formato afetadas a partir do estilo, enquanto LinkedParts seleciona explicitamente tipo de letra, preenchimento, limite, formato de número, alinhamento ou proteção
Editar TXLSXNamedStyle.Style atualiza as partes ligadas sem descartar substituições locais, e GetCellVisibleFormat resolve o resultado em conjunto com as sobreposições da folha de cálculo e os estilos de tabela sem materializar células em branco
TXLSXNamedStyles.FindByName localiza uma entrada de estilo nomeado pelo seu nome de apresentação, sem percorrer manualmente a coleção
Os 60 nomes de estilos de tabela incorporados, claros, médios e escuros, resolvem para formatos de seção completos baseados em temas, partilhados pela saída HTML, PDF, imagem, pré-visualização e viewer
Conversão de fórmulas
TXLSXCell.ConvertFormulaToValue substitui uma fórmula pelo seu valor em cache e TXLSXCells.ConvertFormulasToValues aplica a mesma operação à coleção de células armazenada
Validação de introdução de fórmulas
TXLSXWorkbook.FormulaEntryPolicy e TXLSXWorksheet.ValidateFormulaEntry expõem o contrato partilhado de validação de introdução de fórmulas sem mutações, distinguem texto vazio, funções desconhecidas, nomes desconhecidos, falhas de sintaxe e destinos inválidos, e reconhecem funções de utilizador registadas sem as invocar; veja Política de validação de introdução de fórmulas
Diagnósticos de armazenamento de células
TXLSXCells.PackedStorageEnabled controla o backend RLE compactado usado por escritas em massa tipadas compatíveis row-major, e PackedCellCount reporta as células aí retidas antes que o acesso ao nível de objetos materialize handles estáveis de células
GetStorageStatistics reporta blocos de linhas, linhas povoadas, contagens de bytes de objetos, texto, fórmulas, rich text, compactado estimado, compactado ativo, alocado, usado e de strings compactadas, para decisões de memória mensuráveis; as contagens de payloads de estilo e os bytes de payloads de blanks com estilo evitados expõem diretamente a partilha copy-on-write
Detalhes do AutoFilter
TXLSXAutoFilterColumn.ClearValueFilters limpa filtros de valor e de grupo de datas, retendo a entrada da coluna
HasCriteria2 e AndConnector descrevem filtros personalizados de duas condições; os filtros de cor utilizam HasColorFilter, HasColorFilter_CellColor e HasColorFilter_DxfId; os filtros de ícones utilizam HasIconFilter, HasIconFilter_Set e HasIconFilter_Id
Os filtros dinâmicos utilizam HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal e HasDynamicFilter_MaxValSet; RawXml preserva a carga útil de filtro não suportada
Preenchimentos de gradiente
TXLSXFill.AddGradientStop acrescenta uma paragem de cor. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount e GradientStops expõem geometria linear ou de trajeto
BackgroundColorTheme, BackgroundColorIndex e BackgroundTintAndShade preservam cores de fundo não RGB, e TXLSXFills.AddLinearGradient cria e regista um gradiente linear completo
Gráficos
TXLSXChart expõe PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly e DataLabelsRange
TXLSXChartPlotGroup.Assign copia um grupo de plotagem; ZOrder, BarGrouping, GapWidth e Overlap controlam a sua ordenação e a geometria das barras
TXLSXChartSeries expõe SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos e LabelPosSet
TXLSXChartTrendline expõe Intercept, InterceptSet e Backward, enquanto TXLSXChartAxis.ShowDispUnitsLabel controla o rótulo de unidades de exibição
Formatos condicionais e validações
TXLSXConditionalFormat.ContainsCellFast executa verificações de pertença indexadas, HasStyle comunica um estilo diferencial, e StdDev, EqualAverage e IsPivot expõem sinalizadores avançados de regras
TXLSXDataValidation.ContainsCellFast executa a verificação equivalente de pertença ao intervalo de validação indexada
Tabelas, folhas, ligações, comentários e desenhos
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds e HasHeaderRow preservam metadados de tabela apoiados por consulta e sem cabeçalho
TXLSXSheets.AddCopy duplica uma folha de cálculo com objetos dependentes e ByPos acede à coleção pela posição atual do separador
TXLSXExternalLink.AddDefinedName e DefinedNameCount mantêm nomes externos em cache; TXLSXHyperlink.TargetFrame preserva o contexto de navegação de destino
TXLSXComment.AutoSizeFromText dimensiona a forma do comentário ao seu texto e ClearFont remove execuções de fonte rich-text explícitas
TXLSXImage.SvgData armazena o acompanhante SVG e CameraRange identifica um intervalo de origem de imagem ligada; TXLSXTextBox.PrstToken preserva o token de geometria predefinida do DrawingML
Contrapartes clássicas da folha de cálculo
TXLSWorksheet.ConvertFormulasToValues substitui fórmulas por resultados em cache, as sobrecargas de OpenRTF importam uma tabela RTF no destino predefinido ou selecionado pelo chamador, WriteAutoValue seleciona um tipo de célula a partir de um variant e DefaultFormat expõe o XF predefinido da folha de cálculo