Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines zijn miniatuurgrafieken die in individuele cellen zijn ingebed, geïntroduceerd in Excel 2010. aspose-cells-foss beheert sparklines via SparklineGroup en SparklineGroupCollection (ws.sparkline_groups). Elke groep bevat één of meer Sparkline objecten die dezelfde type- en kleurinstellingen delen.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType is een IntEnum die de visuele vorm van een sparkline-groep identificeert.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Lijn-sparkline — geeft gegevens weer als een doorlopende lijn.
COLUMN1Kolom-sparkline — geeft gegevens weer als verticale balken.
WIN_LOSS2Win/verlies-sparkline — elke waarde wordt weergegeven als een positief of negatief blok.

SparklineEmptyCells

SparklineEmptyCells is een IntEnum die bepaalt hoe lege cellen binnen een sparkline worden behandeld.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Behandelt lege cellen als nul.
GAP1Laat een gat achter waar cellen leeg zijn (lijn wordt onderbroken).
CONNECTED2Verbindt aangrenzende niet-lege waarden, waarbij het gat wordt overgeslagen.

ImageRenderOptions

Een Sparkline bindt een enkel gegevensbereik aan een enkele celpositie.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1-stijl bereik dat de brongegevens voor de sparkline bevat (bijv., "Sheet1!B2:G2").
cell_referencestrA1-stijl celadres waar de sparkline wordt weergegeven (bijv., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrBrongegevensbereik.
cell_referencestrWeergaveceladres.

SparklineGroup

A SparklineGroup definieert de gedeelde visuele instellingen (type, kleuren, behandeling van lege cellen) voor een set sparklines. SparklineGroup objecten worden niet direct geconstrueerd — gebruik ws.sparkline_groups.add(...) of ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline-formulier: LINE, COLUMN, of WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsHoe lege cellen in het gegevensbereik te behandelen.
color_seriesstrKleur voor de hoofd sparkline-lijn/balken, als RRGGBB-hex.
color_negativestrKleur voor negatieve-waarde balken (WIN_LOSS en COLUMN), als RRGGBB-hex.
color_axisstrKleur van de nul-aslijn, als RRGGBB-hex.
color_markersstrKleur van datapuntenmarkeringen op lijn-sparklines, als RRGGBB-hex.
color_firststrMarkeerkleur voor het eerste datapunt, als RRGGBB-hex.
color_laststrMarkeerkleur voor het laatste datapunt, als RRGGBB-hex.
color_highstrMarkeerkleur voor het hoogste datapunt, als RRGGBB-hex.
color_lowstrMarkeerkleur voor het laagste datapunt, als RRGGBB-hex.
sparklineslist[Sparkline]Alleen-lezen lijst van individuele sparklines in deze groep.
countintAantal sparklines in deze groep (alleen-lezen).

ImageRenderOptions

add_sparkline 

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

Voegt een individuele sparkline toe aan deze groep en retourneert de nieuwe Sparkline object.

SparklineGroupCollection

SparklineGroupCollection wordt benaderd als ws.sparkline_groups. Het bevat alle sparkline-groepen op een werkblad.

ImageRenderOptions

add 

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

Maakt een nieuwe groep aan en vult deze eventueel met sparklines afgeleid van data_range (rijen of kolommen afhankelijk van is_vertical) geplaatst in cellen beschreven door location_range. Retourneert de nieuwe SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeVisuele weergave van de sparklines.
data_range`strNone`
is_verticalboolImageRenderOptions True, elke kolom in data_range voedt één sparkline; wanneer False, elke rij dat doet.
location_range`strNone`

add_group 

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

Maakt een lege groep van het opgegeven type aan. Sparklines moeten individueel worden toegevoegd met group.add_sparkline(...).

Eigenschappen en iteratie

ImageRenderOptionsImageRenderOptions
countAantal sparkline-groepen op dit werkblad (alleen-lezen).
__len__()ImageRenderOptions count.
__iter__()Itereert over alle SparklineGroup objecten.
__getitem__(index)Retourneert de SparklineGroup bij nulgebaseerd index.

ImageRenderOptions

Het volgende voorbeeld schrijft maandelijkse omzetgegevens voor drie regio’s en voegt een lijngrafiek-sparkline toe voor elke rij.

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

Zie ook

 Nederlands