Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Le sparklines sono grafici in miniatura incorporati in singole celle, introdotti in Excel 2010. aspose-cells-foss gestisce le sparklines tramite SparklineGroup e SparklineGroupCollection (ws.sparkline_groups). Ogni gruppo contiene uno o più Sparkline oggetti che condividono le stesse impostazioni di tipo e colore.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType è un IntEnum che identifica la forma visiva di un gruppo di sparklines.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Sparklines a linea — visualizza i dati come una linea collegata.
COLUMN1Sparklines a colonna — visualizza i dati come barre verticali.
WIN_LOSS2Sparklines win/loss — ogni valore è mostrato come un blocco positivo o negativo.

SparklineEmptyCells

SparklineEmptyCells è un IntEnum che controlla come le celle vuote vengono gestite all’interno di una sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Tratta le celle vuote come zero.
GAP1Lascia uno spazio dove le celle sono vuote (la linea è interrotta).
CONNECTED2Collega i valori non vuoti adiacenti, saltando lo spazio.

ImageRenderOptions

Una Sparkline associa un singolo intervallo di dati a una singola posizione di cella.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrIntervallo in stile A1 contenente i dati di origine dello sparkline (ad es., "Sheet1!B2:G2").
cell_referencestrIndirizzo di cella in stile A1 dove viene visualizzato lo sparkline (ad es., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrIntervallo di dati di origine.
cell_referencestrIndirizzo della cella di visualizzazione.

SparklineGroup

A SparklineGroup definisce le impostazioni visive condivise (tipo, colori, gestione delle celle vuote) per un insieme di sparklines. SparklineGroup gli oggetti non vengono costruiti direttamente — usa ws.sparkline_groups.add(...) oppure ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeTipo di sparkline: LINE, COLUMN, oppure WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsCome gestire le celle vuote nell’intervallo di dati.
color_seriesstrColore per la linea/barra principale dello sparkline, in esadecimale RRGGBB.
color_negativestrColore per le barre a valore negativo (WIN_LOSS e COLUMN), in esadecimale RRGGBB.
color_axisstrColore della linea dell’asse zero, in esadecimale RRGGBB.
color_markersstrColore dei marcatori dei punti dati sui sparklines a linea, in esadecimale RRGGBB.
color_firststrColore di evidenziazione per il primo punto dati, in esadecimale RRGGBB.
color_laststrColore di evidenziazione per l’ultimo punto dati, in formato esadecimale RRGGBB.
color_highstrColore di evidenziazione per il punto dati più alto, in formato esadecimale RRGGBB.
color_lowstrColore di evidenziazione per il punto dati più basso, in formato esadecimale RRGGBB.
sparklineslist[Sparkline]Elenco di sola lettura dei singoli sparklines in questo gruppo.
countintNumero di sparklines in questo gruppo (sola lettura).

ImageRenderOptions

add_sparkline 

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

Aggiunge un singolo sparkline a questo gruppo e restituisce il nuovo Sparkline oggetto.

SparklineGroupCollection

SparklineGroupCollection si accede come ws.sparkline_groups. Contiene tutti i gruppi di sparkline in un foglio di lavoro.

ImageRenderOptions

aggiungi 

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

Crea un nuovo gruppo e opzionalmente lo popola con sparklines derivati da data_range (righe o colonne a seconda di is_vertical) inseriti nelle celle descritte da location_range. Restituisce il nuovo SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeForma visiva degli sparklines.
data_range`strNone`
is_verticalboolImageRenderOptions True, ogni colonna in data_range fornisce una sparkline; quando False, ogni riga lo fa.
location_range`strNone`

add_group 

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

Crea un gruppo vuoto del tipo specificato. Le sparkline devono essere aggiunte singolarmente con group.add_sparkline(...).

Proprietà e iterazione

ImageRenderOptionsImageRenderOptions
countNumero di gruppi di sparkline in questo foglio di lavoro (sola lettura).
__len__()ImageRenderOptions count.
__iter__()Itera su tutti SparklineGroup oggetti.
__getitem__(index)Restituisce il SparklineGroup a indice zero-based index.

ImageRenderOptions

Il seguente esempio scrive i dati di fatturato mensile per tre regioni e aggiunge una sparkline a linea per ogni riga.

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")

Vedi anche

 Italiano