Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines, tek tek hücrelere gömülü mini grafiklerdir ve Excel 2010’da tanıtılmıştır. aspose-cells-foss, sparklines’ı şu aracılığıyla yönetir SparklineGroup ve SparklineGroupCollection (ws.sparkline_groups). Her grup bir veya daha fazla Sparkline aynı tip ve renk ayarlarını paylaşan nesneler.

Enumerations: aspose.cells_foss

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

SparklineType

SparklineType bir IntEnum sparkline grubunun görsel biçimini tanımlayan.

EnumerationsEnumerationsEnumerations
LINE0Çizgi sparkline — verileri bağlı bir çizgi olarak gösterir.
COLUMN1Sütun sparkline — verileri dikey çubuklar olarak gösterir.
WIN_LOSS2Kazanç/kayıp sparkline — her değer pozitif veya negatif bir blok olarak gösterilir.

SparklineEmptyCells

SparklineEmptyCells bir IntEnum sparkline içinde boş hücrelerin nasıl işleneceğini kontrol eden.

EnumerationsEnumerationsEnumerations
ZERO0Boş hücreleri sıfır olarak kabul eder.
GAP1Hücrelerin boş olduğu yerde bir boşluk bırakır (çizgi kesilir).
CONNECTED2Ardışık boş olmayan değerleri, boşluğu atlayarak bağlar.

Enumerations

Bir Sparkline tek bir veri aralığını tek bir hücre konumuna bağlar.

Enumerations 

Sparkline(data_range: str, cell_reference: str)
EnumerationsEnumerationsEnumerations
data_rangestrA1 biçiminde, sparkline kaynak verilerini içeren aralık (örneğin,., "Sheet1!B2:G2").
cell_referencestrA1 biçiminde, sparkline’ın görüntülendiği hücre adresi (örneğin,., "H2").

Enumerations

EnumerationsEnumerationsEnumerations
data_rangestrKaynak veri aralığı.
cell_referencestrGörüntüleme hücre adresi.

SparklineGroup

A SparklineGroup bir dizi sparkline için ortak görsel ayarları (tip, renkler, boş hücre işleme) tanımlar. SparklineGroup nesneler doğrudan oluşturulmaz — kullanın ws.sparkline_groups.add(...) veya ws.sparkline_groups.add_group(...).

Enumerations

EnumerationsEnumerationsEnumerations
typeSparklineTypeSparkline formu: LINE, COLUMN, veya WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsVeri aralığındaki boş hücrelerin nasıl işleneceği.
color_seriesstrAna sparkline çizgi/çubukları için renk, RRGGBB onaltılık olarak.
color_negativestrNegatif değer çubukları (WIN_LOSS ve COLUMN) için renk, RRGGBB onaltılık olarak.
color_axisstrSıfır eksen çizgisinin rengi, RRGGBB onaltılık olarak.
color_markersstrÇizgi sparkline’larındaki veri noktası işaretçilerinin rengi, RRGGBB onaltılık olarak.
color_firststrİlk veri noktası için vurgulama rengi, RRGGBB onaltılık olarak.
color_laststrSon veri noktası için vurgulama rengi, RRGGBB onaltılık olarak.
color_highstrEn yüksek veri noktası için vurgulama rengi, RRGGBB onaltılık olarak.
color_lowstrEn düşük veri noktası için vurgulama rengi, RRGGBB onaltılık olarak.
sparklineslist[Sparkline]Bu gruptaki bireysel sparkline’ların yalnızca okunabilir listesi.
countintBu gruptaki sparkline sayısı (yalnızca okunabilir).

Enumerations

add_sparkline 

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

Bu gruba tek bir sparkline ekler ve yeni Sparkline nesneyi döndürür.

SparklineGroupCollection

SparklineGroupCollection olarak erişilir ws.sparkline_groups. Çalışma sayfasındaki tüm sparkline gruplarını içerir.

Enumerations

add 

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

Yeni bir grup oluşturur ve isteğe bağlı olarak, şu kaynaktan türetilen sparkline’larla doldurur data_range (satır veya sütun, buna bağlı olarak is_vertical) hücrelere yerleştirilir, tanımlayan location_range. Yeni olanı döndürür SparklineGroup.

EnumerationsEnumerationsEnumerations
sparkline_typeSparklineTypeSparkline’ların görsel biçimi.
data_range`strNone`
is_verticalboolEnumerations True, her sütun içinde data_range bir sparkline besler; ne zaman False, her satır yapar.
location_range`strNone`

add_group 

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

Verilen türde boş bir grup oluşturur. Sparkline’lar tek tek şu ile eklenmelidir group.add_sparkline(...).

Özellikler ve Yineleme

EnumerationsEnumerations
countBu çalışma sayfasındaki sparkline grup sayısı (yalnızca okunabilir).
__len__()Enumerations count.
__iter__()Tüm SparklineGroup nesneler.
__getitem__(index)Şunu döndürür SparklineGroup sıfır tabanlı index.

Enumerations

Aşağıdaki örnek, üç bölge için aylık gelir verilerini yazar ve her satır için bir çizgi sparkline ekler.

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

Ayrıca Bakınız

 Türkçe