Aspose.Cells FOSS
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

A sparklines apró diagramok, amelyeket egyedi cellákba ágyaznak be, és az Excel 2010-ben lettek bevezetve. aspose-cells-foss a sparklines-t kezeli a SparklineGroup és SparklineGroupCollection (ws.sparkline_groups). Minden csoport egy vagy több Sparkline objektumot, amelyek ugyanazt a típust és színbeállítást osztják meg.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType egy IntEnum amely azonosítja a sparkline csoport vizuális formáját.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Vonal sparkline — az adatokat összekapcsolt vonalként jeleníti meg.
COLUMN1Oszlop sparkline — az adatokat függőleges sávokként jeleníti meg.
WIN_LOSS2Nyereség/veszteség sparkline — minden érték pozitív vagy negatív blokként jelenik meg.

SparklineEmptyCells

SparklineEmptyCells egy IntEnum amely szabályozza, hogyan kezelje a sparkline-ban az üres cellákat.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Üres cellákat nullaként kezel.
GAP1Hagy egy hézagot, ahol a cellák üresek (a vonal megszakad).
CONNECTED2Összeköti a szomszédos nem üres értékeket, átugorva a hézagot.

ImageRenderOptions

Egy Sparkline egyetlen adat tartományt köt egyetlen cella helyhez.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1-stílusú tartomány, amely a sparkline forrásadatokat tartalmazza (pl., "Sheet1!B2:G2").
cell_referencestrA1-stílusú cellacím, ahol a sparkline megjelenik (pl., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrForrásadat-tartomány.
cell_referencestrMegjelenítési cellacím.

SparklineGroup

A SparklineGroup definiálja a közös vizuális beállításokat (típus, színek, üres cellák kezelése) egy sor sparkline-hoz. SparklineGroup objektumok nem épülnek közvetlenül — használja ws.sparkline_groups.add(...) vagy ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline forma: LINE, COLUMN, vagy WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsHogyan kezelje az üres cellákat az adatintervallumban.
color_seriesstrA fő sparkline vonal/sáv színe, RRGGBB hex.
color_negativestrA negatív értékű sávok (WIN_LOSS és COLUMN) színe, RRGGBB hex.
color_axisstrA nulla tengely vonal színe, RRGGBB hex.
color_markersstrAz adatpont jelölők színe a vonal-sparklines-on, RRGGBB hex formátumban.
color_firststrKiemelés színe az első adatponthoz, RRGGBB hex formátumban.
color_laststrKiemelés színe az utolsó adatponthoz, RRGGBB hex formátumban.
color_highstrKiemelés színe a legmagasabb adatponthoz, RRGGBB hex formátumban.
color_lowstrKiemelés színe a legalacsonyabb adatponthoz, RRGGBB hex formátumban.
sparklineslist[Sparkline]Csak olvasható lista az egyes sparklines-ekről ebben a csoportban.
countintA sparklines-ek száma ebben a csoportban (csak olvasható).

ImageRenderOptions

add_sparkline 

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

Hozzáad egy egyedi sparkline-t ehhez a csoporthoz, és visszaadja az új Sparkline objektum.

SparklineGroupCollection

SparklineGroupCollection elérhető mint ws.sparkline_groups. Tartalmazza a munkalapon lévő összes sparkline csoportot.

ImageRenderOptions

add 

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

Létrehoz egy új csoportot, és opcionálisan feltölti a belőle származó sparklines-ekkel data_range (sorok vagy oszlopok attól függően, hogy is_vertical) helyezve a cellákba, amelyet leírja location_range. Visszaadja az új SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeA sparklines vizuális formáját.
data_range`strNone`
is_verticalboolImageRenderOptions True, minden oszlop a data_range egy sparkline-t táplál; amikor False, minden sor ezt teszi.
location_range`strNone`

add_group 

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

Létrehoz egy üres csoportot a megadott típusban. A sparklines-eket egyenként kell hozzáadni a következővel group.add_sparkline(...).

Tulajdonságok és iteráció

ImageRenderOptionsImageRenderOptions
countA munkalapon lévő sparkline csoportok száma (csak olvasható).
__len__()ImageRenderOptions count.
__iter__()Iterál az összes SparklineGroup objektumon.
__getitem__(index)Visszaadja a SparklineGroup nulla‑alapú index.

ImageRenderOptions

Az alábbi példa havi bevételi adatokat ír három régióra, és minden sorhoz egy vonal-sparkline-t ad hozzá.

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

Lásd még

 Magyar