Aspose.Cells FOSS (Tanah longsor)
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines adalah diagram miniatur yang disematkan dalam sel individual, diperkenalkan di Excel 2010. aspose-cells-foss mengelola sparklines melalui SparklineGroup dan SparklineGroupCollection (ws.sparkline_groups). Setiap grup berisi satu atau lebih Sparkline objek yang berbagi tipe dan pengaturan warna yang sama.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType adalah sebuah IntEnum yang mengidentifikasi bentuk visual dari grup sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Sparkline Garis — menampilkan data sebagai garis yang terhubung.
COLUMN1Sparkline Kolom — menampilkan data sebagai batang vertikal.
WIN_LOSS2Sparkline Menang/Kalah — setiap nilai ditampilkan sebagai blok positif atau negatif.

SparklineEmptyCells

SparklineEmptyCells adalah sebuah IntEnum yang mengontrol bagaimana sel kosong ditangani dalam sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Menganggap sel kosong sebagai nol.
GAP1Meninggalkan celah di mana sel kosong (garis terputus).
CONNECTED2Menghubungkan nilai non-kosong yang berdekatan, melewati celah.

ImageRenderOptions

Sebuah Sparkline mengikat satu rentang data ke satu lokasi sel.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrRentang gaya A1 yang berisi data sumber sparkline (misalnya,., "Sheet1!B2:G2").
cell_referencestrAlamat sel gaya A1 tempat sparkline ditampilkan (misalnya,., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrRentang data sumber.
cell_referencestrAlamat sel tampilan.

SparklineGroup

A SparklineGroup menentukan pengaturan visual bersama (tipe, warna, penanganan sel kosong) untuk sekumpulan sparkline. SparklineGroup objek tidak dibangun secara langsung — gunakan ws.sparkline_groups.add(...) atau ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeFormulir Sparkline: LINE, COLUMN, atau WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsCara menangani sel kosong dalam rentang data.
color_seriesstrWarna untuk garis/bar utama sparkline, dalam format heksadesimal RRGGBB.
color_negativestrWarna untuk bar nilai negatif (WIN_LOSS dan COLUMN), dalam format heksadesimal RRGGBB.
color_axisstrWarna garis sumbu nol, dalam format heksadesimal RRGGBB.
color_markersstrWarna penanda titik data pada sparkline garis, dalam format heksadesimal RRGGBB.
color_firststrWarna sorotan untuk titik data pertama, dalam format heksadesimal RRGGBB.
color_laststrWarna sorotan untuk titik data terakhir, dalam format heksadesimal RRGGBB.
color_highstrWarna sorotan untuk titik data tertinggi, dalam format heksadesimal RRGGBB.
color_lowstrWarna sorotan untuk titik data terendah, dalam format heksadesimal RRGGBB.
sparklineslist[Sparkline]Daftar hanya-baca dari sparkline individu dalam grup ini.
countintJumlah sparkline dalam grup ini (hanya-baca).

ImageRenderOptions

add_sparkline 

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

Menambahkan sparkline individu ke grup ini dan mengembalikan yang baru Sparkline objek.

SparklineGroupCollection

SparklineGroupCollection diakses sebagai ws.sparkline_groups. Ini berisi semua grup sparkline pada lembar kerja.

ImageRenderOptions

add 

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

Membuat grup baru dan secara opsional mengisinya dengan sparkline yang dihasilkan dari data_range (baris atau kolom tergantung pada is_vertical) ditempatkan ke sel yang dijelaskan oleh location_range. Mengembalikan yang baru SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeBentuk visual dari sparkline.
data_range`strNone`
is_verticalboolImageRenderOptions True, setiap kolom dalam data_range menyediakan satu sparkline; ketika False, setiap baris melakukannya.
location_range`strNone`

add_group 

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

Membuat grup kosong dengan tipe yang diberikan. Sparkline harus ditambahkan secara individual dengan group.add_sparkline(...).

Properti dan Iterasi

ImageRenderOptionsImageRenderOptions
countJumlah grup sparkline pada lembar kerja ini (hanya-baca).
__len__()ImageRenderOptions count.
__iter__()Iterasi atas semua SparklineGroup objek.
__getitem__(index)Mengembalikan yang SparklineGroup pada berbasis nol index.

ImageRenderOptions

Contoh berikut menulis data pendapatan bulanan untuk tiga wilayah dan menambahkan 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 Indonesia