Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparkline ir miniātūras diagrammas, kas iegultas atsevišķās šūnās, ieviestas Excel 2010. aspose-cells-foss pārvalda sparkline caur SparklineGroup un SparklineGroupCollection (ws.sparkline_groups). Katrs grupa satur vienu vai vairākus Sparkline objektus, kuriem ir vienādi tipa un krāsu iestatījumi.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType ir IntEnum identificē sparkline grupas vizuālo formu.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Līnijas sparkline — attēlo datus kā savienotu līniju.
COLUMN1Kolonnas sparkline — attēlo datus kā vertikālus stabiņus.
WIN_LOSS2Uzvaras/pazaudējuma sparkline — katra vērtība tiek parādīta kā pozitīvs vai negatīvs bloks.

SparklineEmptyCells

SparklineEmptyCells ir IntEnum kontrolē, kā tukšas šūnas tiek apstrādātas sparklīnē.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Uzskata tukšas šūnas par nulli.
GAP1Atstāj plaisu tur, kur šūnas ir tukšas (līnija ir pārtraukta).
CONNECTED2Savieno blakus esošās ne‑tukšās vērtības, izlaidot plaisu.

ImageRenderOptions

A Sparkline saista vienu datu diapazonu ar vienu šūnas atrašanās vietu.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1 stila diapazons, kas satur sparklīnē avota datus (piemēram,., "Sheet1!B2:G2").
cell_referencestrA1 stila šūnas adrese, kur tiek parādīta sparklīne (piemēram,., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrAvota datu diapazons.
cell_referencestrAttēlošanas šūnas adrese.

SparklineGroup

A SparklineGroup definē kopīgus vizuālos iestatījumus (tips, krāsas, tukšu šūnu apstrāde) kopai sparklines. SparklineGroup objekti netiek konstruēti tieši — izmantojiet ws.sparkline_groups.add(...) vai ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline forma: LINE, COLUMN, vai WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsKā apstrādāt tukšas šūnas datu diapazonā.
color_seriesstrKrāsa galvenajai sparkline līnijai/stabiņiem, kā RRGGBB heksadecimālais.
color_negativestrKrāsa negatīvo vērtību stabiņiem (WIN_LOSS un COLUMN), kā RRGGBB heksadecimālais.
color_axisstrNulles ass līnijas krāsa, kā RRGGBB heksadecimālais.
color_markersstrDatu punktu marķieru krāsa līniju sparklines, kā RRGGBB heksadecimālais.
color_firststrIzcelšanas krāsa pirmajam datu punktam, kā RRGGBB heksadecimālais.
color_laststrIzcelšanas krāsa pēdējam datu punktam, kā RRGGBB heksadecimālais.
color_highstrIzcelšanas krāsa augstākajam datu punktam, kā RRGGBB heksadecimālais.
color_lowstrIzcelšanas krāsa zemākajam datu punktam, kā RRGGBB heksadecimālais.
sparklineslist[Sparkline]Tikai lasāms saraksts ar atsevišķām sparklines šajā grupā.
countintSparklines skaits šajā grupā (tikai lasāms).

ImageRenderOptions

add_sparkline 

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

Pievieno individuālu sparkline šai grupai un atgriež jauno Sparkline objektu.

SparklineGroupCollection

SparklineGroupCollection tiek piekļūts kā ws.sparkline_groups. Tas satur visas sparkline grupas darblapā.

ImageRenderOptions

pievienot 

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

Izveido jaunu grupu un pēc izvēles piepilda to ar sparklines, kas izriet no data_range (rindas vai kolonnas atkarībā no is_vertical) ievietotas šūnās, kas aprakstītas ar location_range. Atgriež jauno SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeSparklines vizuālā forma.
data_range`strNone`
is_verticalboolImageRenderOptions True, katra kolonna iekš data_range pievieno vienu sparklini; kad False, katra rinda to dara.
location_range`strNone`

add_group 

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

Izveido tukšu grupu norādītā tipa. Sparklini jāpiešķir individuāli, izmantojot group.add_sparkline(...).

Īpašības un iterācija

ImageRenderOptionsImageRenderOptions
countSparkline grupu skaits šajā darblapā (tikai lasāms).
__len__()ImageRenderOptions count.
__iter__()Iterē pār visiem SparklineGroup objektus.
__getitem__(index)Atgriež SparklineGroup ar nulles bāzes index.

ImageRenderOptions

Šis piemērs ieraksta ikmēneša ieņēmumu datus trīs reģioniem un pievieno līnijas sparkline katrai rindai.

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

Skatīt arī

 Latviešu