Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines ialah carta miniatur yang disematkan dalam sel individu, diperkenalkan dalam Excel 2010. aspose-cells-foss menguruskan sparklines melalui SparklineGroup dan SparklineGroupCollection (ws.sparkline_groups). Setiap kumpulan memegang satu atau lebih Sparkline objek yang berkongsi jenis dan tetapan warna yang sama.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType adalah satu IntEnum yang mengenal pasti bentuk visual kumpulan sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Sparkline Garis — memaparkan data sebagai garis bersambung.
COLUMN1Sparkline Lajur — memaparkan data sebagai bar menegak.
WIN_LOSS2Sparkline Menang/Kehilangan — setiap nilai ditunjukkan sebagai blok positif atau negatif.

SparklineEmptyCells

SparklineEmptyCells adalah satu IntEnum yang mengawal cara sel kosong ditangani dalam sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Menganggap sel kosong sebagai sifar.
GAP1Meninggalkan jurang di mana sel kosong (garis terputus).
CONNECTED2Menyambungkan nilai tidak kosong yang bersebelahan, melangkau jurang.

ImageRenderOptions

Satu Sparkline mengikat satu julat data kepada satu lokasi sel.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrJulat gaya A1 yang mengandungi data sumber sparkline (contohnya,., "Sheet1!B2:G2").
cell_referencestrAlamat sel gaya A1 di mana sparkline dipaparkan (contohnya,., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrJulat data sumber.
cell_referencestrAlamat sel paparan.

SparklineGroup

A SparklineGroup menentukan tetapan visual yang dikongsi (jenis, warna, pengendalian sel kosong) untuk satu set sparkline. SparklineGroup objek tidak dibina secara langsung — gunakan ws.sparkline_groups.add(...) atau ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeBorang Sparkline: LINE, COLUMN, atau WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsBagaimana untuk mengendalikan sel kosong dalam julat data.
color_seriesstrWarna untuk garisan/bar utama sparkline, dalam bentuk heks RRGGBB.
color_negativestrWarna untuk bar nilai negatif (WIN_LOSS dan COLUMN), dalam bentuk heks RRGGBB.
color_axisstrWarna garis paksi sifar, dalam bentuk heks RRGGBB.
color_markersstrWarna penanda titik data pada sparkline garis, dalam format heks RRGGBB.
color_firststrWarna sorotan untuk titik data pertama, dalam format heks RRGGBB.
color_laststrWarna sorotan untuk titik data terakhir, dalam format heks RRGGBB.
color_highstrWarna sorotan untuk titik data tertinggi, dalam format heks RRGGBB.
color_lowstrWarna sorotan untuk titik data terendah, dalam format heks RRGGBB.
sparklineslist[Sparkline]Senarai baca-sahaja bagi sparkline individu dalam kumpulan ini.
countintBilangan sparkline dalam kumpulan ini (baca-sahaja).

ImageRenderOptions

add_sparkline 

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

Menambah sparkline individu ke kumpulan ini dan mengembalikan yang baru Sparkline objek.

SparklineGroupCollection

SparklineGroupCollection diakses sebagai ws.sparkline_groups. Ia mengandungi semua kumpulan sparkline pada lembar kerja.

ImageRenderOptions

add 

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

Mencipta kumpulan baru dan secara pilihan mengisinya dengan sparkline yang dihasilkan daripada data_range (baris atau lajur bergantung pada is_vertical) diletakkan ke dalam sel yang diterangkan oleh location_range. Mengembalikan yang baru SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeBentuk visual sparkline.
data_range`strNone`
is_verticalboolImageRenderOptions True, setiap lajur dalam data_range menyumbang satu sparkline; apabila False, setiap baris melakukannya.
location_range`strNone`

add_group 

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

Mencipta kumpulan kosong bagi jenis yang diberikan. Sparkline mesti ditambah secara individu dengan group.add_sparkline(...).

Sifat dan Iterasi

ImageRenderOptionsImageRenderOptions
countBilangan kumpulan sparkline pada lembar kerja ini (baca-sahaja).
__len__()ImageRenderOptions count.
__iter__()Mengulangi semua SparklineGroup objek.
__getitem__(index)Mengembalikan SparklineGroup pada berasaskan sifar index.

ImageRenderOptions

Contoh berikut menulis data pendapatan bulanan untuk tiga wilayah dan menambah sparkline garis untuk setiap baris.

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

Lihat Juga

 Bahasa Melayu