Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklinai yra miniatiūrinės diagramos, įterptos į atskirus langelius, pristatytos Excel 2010. aspose-cells-foss valdo sparkline per SparklineGroup ir SparklineGroupCollection (ws.sparkline_groups). Kiekviena grupė turi vieną arba kelias Sparkline objektų, turinčių tuos pačius tipo ir spalvų nustatymus.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType yra IntEnum identifikuojantis sparkline grupės vizualinę formą.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Linijinis sparkline — atvaizduoja duomenis kaip susietą liniją.
COLUMN1Stulpelinė sparkline — atvaizduoja duomenis kaip vertikalias juostas.
WIN_LOSS2Laimėjimo/pralaimėjimo sparkline — kiekviena reikšmė rodoma kaip teigiamas arba neigiamas blokas.

SparklineEmptyCells

SparklineEmptyCells yra IntEnum kontroliuojantis, kaip tušti langeliai apdorojami sparkline viduje.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Traktuojami tušti langeliai kaip nulis.
GAP1Palieka tarpą, kur langeliai yra tušti (linija nutraukiama).
CONNECTED2Sujungia gretimas ne tuščias reikšmes, praleidžiant tarpą.

ImageRenderOptions

A Sparkline pririša vieną duomenų diapazoną prie vienos ląstelės vietos.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1 stiliaus diapazonas, kuriame yra sparkline šaltinio duomenys (pvz., "Sheet1!B2:G2").
cell_referencestrA1 stiliaus ląstelės adresas, kuriame rodomas sparkline (pvz.,)., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrŠaltinio duomenų diapazonas.
cell_referencestrRodyti langelio adresą.

SparklineGroup

A SparklineGroup apibrėžia bendrus vizualinius nustatymus (tipas, spalvos, tuščių langelių tvarkymas) rinkinui sparklinių diagramų. SparklineGroup objektai nėra kuriami tiesiogiai — naudokite ws.sparkline_groups.add(...) arba ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline forma: LINE, COLUMN, arba WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsKaip tvarkyti tuščius langelius duomenų diapazone.
color_seriesstrPagrindinės sparkline linijos/stulpelių spalva, kaip RRGGBB šešioliktainis kodas.
color_negativestrNeigiamų verčių stulpelių (WIN_LOSS ir COLUMN) spalva, kaip RRGGBB šešioliktainis kodas.
color_axisstrNulinės ašies linijos spalva, kaip RRGGBB šešioliktainis kodas.
color_markersstrLinijinių sparkline duomenų taškų žymeklių spalva, kaip RRGGBB šešioliktainis kodas.
color_firststrPirmojo duomenų taško paryškinimo spalva, kaip RRGGBB šešioliktainis kodas.
color_laststrPaskutinio duomenų taško paryškinimo spalva, kaip RRGGBB šešioliktainis kodas.
color_highstrDidžiausio duomenų taško paryškinimo spalva, kaip RRGGBB šešioliktainis kodas.
color_lowstrMažiausio duomenų taško paryškinimo spalva, kaip RRGGBB šešioliktainis kodas.
sparklineslist[Sparkline]Tik skaitymui skirta atskirų sparkline elementų sąrašas šioje grupėje.
countintSparkline elementų skaičius šioje grupėje (tik skaitymui).

ImageRenderOptions

add_sparkline 

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

Prideda atskirą sparkline elementą į šią grupę ir grąžina naują Sparkline objektą.

SparklineGroupCollection

SparklineGroupCollection prieiga vykdoma kaip ws.sparkline_groups. Jame yra visos sparkline grupės darbalapyje.

ImageRenderOptions

add 

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

Sukuria naują grupę ir, jei reikia, užpildo ją sparkline elementais, gautais iš data_range (eilučių arba stulpelių, priklausomai nuo is_vertical) įdėtų į langelius, aprašytus pagal location_range. Grąžina naują SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeSparklinių vizualinė forma.
data_range`strNone`
is_verticalboolImageRenderOptions True, kiekvienas stulpelis data_range pateikia vieną sparkliną; kai False, kiekviena eilutė tai daro.
location_range`strNone`

add_group 

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

Sukuria tuščią grupę nurodyto tipo. Sparklines turi būti pridedami atskirai su group.add_sparkline(...).

Savybės ir iteravimas

ImageRenderOptionsImageRenderOptions
countSparkline grupių skaičius šiame darbalapyje (tik skaityti).
__len__()ImageRenderOptions count.
__iter__()Iteruoja per visus SparklineGroup objektus.
__getitem__(index)Grąžina SparklineGroup nulio pagrindu index.

ImageRenderOptions

Toliau pateiktas pavyzdys įrašo mėnesio pajamų duomenis trijoms regionams ir prideda linijinį sparkline kiekvienai eilutei.

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

Žr. taip pat

 Lietuvių