- Não, não.
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines são gráficos em miniatura incorporados em células individuais, introduzidos no Excel 2010. aspose-cells-foss gerencia sparklines através de SparklineGroup e SparklineGroupCollection (ws.sparkline_groups). Cada grupo contém um ou mais Sparkline objetos que compartilham o mesmo tipo e configurações de cor.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import SparklineType, SparklineEmptyCells, Sparkline, SparklineGroup

SparklineType

SparklineType é um IntEnum identificando a forma visual de um grupo de sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Sparkline de linha — renderiza os dados como uma linha conectada.
COLUMN1Sparkline de coluna — renderiza os dados como barras verticais.
WIN_LOSS2Sparkline de ganho/perda — cada valor é exibido como um bloco positivo ou negativo.

SparklineEmptyCells

SparklineEmptyCells é um IntEnum controlando como as células vazias são tratadas dentro de um sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Trata células vazias como zero.
GAP1Deixa um espaço onde as células estão vazias (a linha é interrompida).
CONNECTED2Conecta valores não vazios adjacentes, ignorando o espaço.

ImageRenderOptions

Um Sparkline vincula um único intervalo de dados a um único local de célula.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrIntervalo no estilo A1 contendo os dados de origem do sparkline (por exemplo,., "Sheet1!B2:G2").
cell_referencestrEndereço de célula no estilo A1 onde o sparkline é exibido (por exemplo,., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrIntervalo de dados de origem.
cell_referencestrExibir endereço da célula.

SparklineGroup

A SparklineGroup define as configurações visuais compartilhadas (tipo, cores, tratamento de células vazias) para um conjunto de sparklines. SparklineGroup os objetos não são construídos diretamente — use ws.sparkline_groups.add(...) ou ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeForma de Sparkline: LINE, COLUMN, ou WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsComo tratar células vazias no intervalo de dados.
color_seriesstrCor da linha/barras principal do sparkline, como hex RRGGBB.
color_negativestrCor das barras de valor negativo (WIN_LOSS e COLUMN), como hex RRGGBB.
color_axisstrCor da linha do eixo zero, como hex RRGGBB.
color_markersstrCor dos marcadores de ponto de dados em sparklines de linha, como hex RRGGBB.
color_firststrCor de destaque para o primeiro ponto de dados, como hex RRGGBB.
color_laststrCor de destaque para o último ponto de dados, como hex RRGGBB.
color_highstrCor de destaque para o ponto de dados mais alto, como hex RRGGBB.
color_lowstrCor de destaque para o ponto de dados mais baixo, como hex RRGGBB.
sparklineslist[Sparkline]Lista somente leitura de sparklines individuais neste grupo.
countintNúmero de sparklines neste grupo (somente leitura).

ImageRenderOptions

add_sparkline 

group.add_sparkline(data_range: str, cell_reference: str) -> Sparkline

Adiciona um sparkline individual a este grupo e retorna o novo Sparkline objeto.

SparklineGroupCollection

SparklineGroupCollection é acessado como ws.sparkline_groups. Contém todos os grupos de sparkline em uma planilha.

ImageRenderOptions

adicionar 

ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range=None,
    is_vertical=False,
    location_range=None
) -> SparklineGroup

Cria um novo grupo e, opcionalmente, o preenche com sparklines derivados de data_range (linhas ou colunas dependendo de is_vertical) colocados em células descritas por location_range. Retorna o novo SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeForma visual dos sparklines.
data_range`strNone`
is_verticalboolImageRenderOptions True, cada coluna em data_range alimenta um sparkline; quando False, cada linha faz.
location_range`strNone`

add_group 

ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroup

Cria um grupo vazio do tipo especificado. Os sparklines devem ser adicionados individualmente com group.add_sparkline(...).

Propriedades e Iteração

ImageRenderOptionsImageRenderOptions
countNúmero de grupos de sparkline nesta planilha (somente leitura).
__len__()ImageRenderOptions count.
__iter__()Itera sobre todos SparklineGroup objetos.
__getitem__(index)Retorna o SparklineGroup em base zero index.

ImageRenderOptions

O exemplo a seguir grava dados de receita mensal para três regiões e adiciona um sparkline de linha para cada linha.

from aspose.cells_foss import Workbook, SparklineType, SparklineEmptyCells

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Trends"

# Write headers
months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
for col, m in enumerate(months):
    ws.cells[0][col + 1].put_value(m)

ws.cells["A1"].put_value("Region")
ws.cells["H1"].put_value("Trend")

# Write three rows of data
regions = [
    ("North", [12000, 14500, 13800, 16200, 15900, 17400]),
    ("South", [9800,  10200, 11500, 10900, 12300, 13100]),
    ("West",  [7500,   8100,  7900,  8800,  9200, 10500]),
]
for row_i, (name, values) in enumerate(regions, start=1):
    ws.cells[row_i][0].put_value(name)
    for col_i, v in enumerate(values):
        ws.cells[row_i][col_i + 1].put_value(v)

# Add a line sparkline group — one sparkline per data row
group = ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range="Trends!B2:G4",
    is_vertical=False,
    location_range="Trends!H2:H4",
)

# Customize colors
group.color_series = "4472C4"       # blue lines
group.color_high   = "70AD47"       # green for peak
group.color_low    = "FF0000"       # red for trough
group.display_empty_cells_as = SparklineEmptyCells.GAP

wb.save("sparklines.xlsx")

Veja Também

 Português