Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines er miniatyrdiagrammer som er innebygd i individuelle celler, introdusert i Excel 2010. aspose-cells-foss håndterer sparklines gjennom SparklineGroup og SparklineGroupCollection (ws.sparkline_groups). Hver gruppe inneholder én eller flere Sparkline objekter som deler samme type og fargeinnstillinger.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType er en IntEnum som identifiserer den visuelle formen til en sparkline-gruppe.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Linje-sparkline — gjengir data som en sammenhengende linje.
COLUMN1Kolonne-sparkline — gjengir data som vertikale stolper.
WIN_LOSS2Vinn/tap-sparkline — hver verdi vises som en positiv eller negativ blokk.

SparklineEmptyCells

SparklineEmptyCells er en IntEnum som styrer hvordan tomme celler håndteres i en sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Behandler tomme celler som null.
GAP1Lar det være et gap der celler er tomme (linjen brytes).
CONNECTED2Kobler tilstøtende ikke-tomme verdier, og hopper over gapet.

ImageRenderOptions

En Sparkline binder et enkelt dataintervall til en enkelt celleplassering.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1-stil område som inneholder kilde data for sparkline (f.eks., "Sheet1!B2:G2").
cell_referencestrA1-stil celleadresse hvor sparkline vises (f.eks., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrKilde dataområde.
cell_referencestrVisningscelleadresse.

SparklineGroup

A SparklineGroup definerer de delte visuelle innstillingene (type, farger, håndtering av tomme celler) for et sett med sparklines. SparklineGroup objekter konstrueres ikke direkte — bruk ws.sparkline_groups.add(...) eller ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline‑skjema: LINE, COLUMN, eller WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsHvordan håndtere tomme celler i dataintervallet.
color_seriesstrFarge for hoved‑sparkline‑linje/‑stolper, som RRGGBB‑hex.
color_negativestrFarge for stolper med negative verdier (WIN_LOSS og COLUMN), som RRGGBB‑hex.
color_axisstrFarge på null‑akslinjen, som RRGGBB‑hex.
color_markersstrFarge på datapunkt‑markører på linje‑sparklines, som RRGGBB‑hex.
color_firststrUthevingsfarge for det første datapunktet, som RRGGBB‑hex.
color_laststrUthevingsfarge for det siste datapunktet, som RRGGBB‑hex.
color_highstrUthevingsfarge for det høyeste datapunktet, som RRGGBB‑hex.
color_lowstrUthevingsfarge for det laveste datapunktet, som RRGGBB‑hex.
sparklineslist[Sparkline]Skrivebeskyttet liste over individuelle sparklines i denne gruppen.
countintAntall sparklines i denne gruppen (kun lesing).

ImageRenderOptions

add_sparkline 

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

Legger til en individuell sparkline i denne gruppen og returnerer den nye Sparkline objekt.

SparklineGroupCollection

SparklineGroupCollection tilgås som ws.sparkline_groups. Den inneholder alle sparkline-grupper på et regneark.

ImageRenderOptions

legg til 

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

Oppretter en ny gruppe og kan eventuelt fylle den med sparklines avledet fra data_range (rader eller kolonner avhengig av is_vertical) plassert i celler beskrevet av location_range. Returnerer den nye SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeVisuell form av sparklines.
data_range`strNone`
is_verticalboolImageRenderOptions True, hver kolonne i data_range forsyner en sparkline; når False, hver rad gjør det.
location_range`strNone`

add_group 

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

Oppretter en tom gruppe av den angitte typen. Sparklines må legges til individuelt med group.add_sparkline(...).

Egenskaper og iterasjon

ImageRenderOptionsImageRenderOptions
countAntall sparkline-grupper på dette regnearket (kun lesing).
__len__()ImageRenderOptions count.
__iter__()Itererer over alle SparklineGroup objekter.
__getitem__(index)Returnerer den SparklineGroup ved nullbasert index.

ImageRenderOptions

Følgende eksempel skriver månedlige inntektsdata for tre regioner og legger til en linje-sparkline for hver rad.

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

Se også

 Norsk