Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines är miniatyrdiagram som är inbäddade i enskilda celler, introducerade i Excel 2010. aspose-cells-foss hanterar sparklines genom SparklineGroup och SparklineGroupCollection (ws.sparkline_groups). Varje grupp innehåller en eller flera Sparkline objekt som delar samma typ- och färginställningar.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType är en IntEnum som identifierar den visuella formen för en sparkline-grupp.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Linjesparkline — renderar data som en sammanhängande linje.
COLUMN1Kolumnsparkline — renderar data som vertikala staplar.
WIN_LOSS2Vinst/förlust-sparkline — varje värde visas som ett positivt eller negativt block.

SparklineEmptyCells

SparklineEmptyCells är en IntEnum som styr hur tomma celler hanteras inom en sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Behandlar tomma celler som noll.
GAP1Lämnar ett gap där celler är tomma (linjen bryts).
CONNECTED2Ansluter intilliggande icke-tomma värden och hoppar över gapet.

ImageRenderOptions

En Sparkline binder ett enda dataområde till en enskild cellplats.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1-style-intervall som innehåller sparkline‑källdata (t.ex., "Sheet1!B2:G2").
cell_referencestrA1-style celladress där sparkline visas (t.ex., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrKälldataintervall.
cell_referencestrVisningscelladress.

SparklineGroup

A SparklineGroup definierar de delade visuella inställningarna (typ, färger, hantering av tomma celler) för en uppsättning sparklines. SparklineGroup objekt konstrueras inte direkt — använd ws.sparkline_groups.add(...) eller ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline-formulär: LINE, COLUMN, eller WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsHur tomma celler i dataområdet ska hanteras.
color_seriesstrFärg för huvudlinjen/ staplarna i sparkline, som RRGGBB-hex.
color_negativestrFärg för staplar med negativt värde (WIN_LOSS och COLUMN), som RRGGBB-hex.
color_axisstrFärg på nollaxelns linje, som RRGGBB-hex.
color_markersstrFärg på datapunktmarkörer i linje-sparklines, som RRGGBB-hex.
color_firststrMarkeringsfärg för den första datapunkten, som RRGGBB-hex.
color_laststrMarkeringsfärg för den sista datapunkten, som RRGGBB-hex.
color_highstrMarkeringsfärg för den högsta datapunkten, som RRGGBB-hex.
color_lowstrMarkeringsfärg för den lägsta datapunkten, som RRGGBB-hex.
sparklineslist[Sparkline]Skrivskyddad lista över enskilda sparklines i den här gruppen.
countintAntal sparklines i den här gruppen (skrivskyddad).

ImageRenderOptions

add_sparkline 

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

Lägger till en individuell sparkline i den här gruppen och returnerar den nya Sparkline objektet.

SparklineGroupCollection

SparklineGroupCollection åtkoms som ws.sparkline_groups. Den innehåller alla sparkline-grupper på ett kalkylblad.

ImageRenderOptions

add 

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

Skapar en ny grupp och fyller eventuellt den med sparklines hämtade från data_range (rader eller kolumner beroende på is_vertical) placerade i celler som beskrivs av location_range. Returnerar den nya SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeVisuella formen av sparklines.
data_range`strNone`
is_verticalboolImageRenderOptions True, varje kolumn i data_range förser en sparkline; när False, varje rad gör det.
location_range`strNone`

add_group 

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

Skapar en tom grupp av given typ. Sparklines måste läggas till individuellt med group.add_sparkline(...).

Egenskaper och iteration

ImageRenderOptionsImageRenderOptions
countAntal sparkline-grupper på detta kalkylblad (endast läsning).
__len__()ImageRenderOptions count.
__iter__()Itererar över alla SparklineGroup objekt.
__getitem__(index)Returnerar den SparklineGroup vid nollbaserad index.

ImageRenderOptions

Följande exempel skriver månatliga intäktsdata för tre regioner och lägger till en linjesparkline för varje 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 även

 Svenska