Aspose.Cells FOSS
Python
Sparkline

Sparkline

Sparklines คือแผนภูมิขนาดจิ๋วที่ฝังอยู่ในเซลล์แต่ละเซลล์, แนะนำครั้งแรกใน Excel 2010. aspose-cells-foss จัดการ sparklines ผ่าน SparklineGroup และ SparklineGroupCollection (ws.sparkline_groups). แต่ละกลุ่มมีหนึ่งหรือหลาย Sparkline objects ที่ใช้ประเภทและการตั้งค่าสีเดียวกัน.

Properties: aspose.cells_foss

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

SparklineType

SparklineType คือ IntEnum ที่ระบุรูปแบบการแสดงผลของกลุ่ม sparkline.

NameTypeAccessDescription
data_range``ReadGets the data range.
cell_reference``ReadGets the cell reference.

SparklineEmptyCells

SparklineEmptyCells คือ IntEnum ที่ควบคุมวิธีการจัดการเซลล์ว่างภายใน sparkline.

SignatureDescription
__init__(data_range: str, cell_reference: str)
copy()Creates and returns a duplicate of this Sparkline object

Properties

A Sparkline ผูกช่วงข้อมูลเดียวกับตำแหน่งเซลล์เดียว.

Properties 

Sparkline(data_range: str, cell_reference: str)

Properties

SparklineGroup

A SparklineGroup กำหนดการตั้งค่าภาพรวมที่ใช้ร่วมกัน (ประเภท, สี, การจัดการเซลล์ว่าง) สำหรับชุดของสปาร์คลไลน์. SparklineGroup อ็อบเจกต์ไม่ได้ถูกสร้างโดยตรง — ใช้ ws.sparkline_groups.add(...) หรือ ws.sparkline_groups.add_group(...).

Properties

Properties

add_sparkline 

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

เพิ่มสปาร์กไลน์แต่ละตัวเข้าไปในกลุ่มนี้และคืนค่าใหม่ Sparkline อ็อบเจกต์.

SparklineGroupCollection

SparklineGroupCollection เข้าถึงได้เป็น ws.sparkline_groups. มันประกอบด้วยกลุ่มสปาร์คลไลน์ทั้งหมดในแผ่นงานหนึ่ง.

Properties

add 

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

สร้างกลุ่มใหม่และโดยอาจเติมข้อมูลด้วยสปาร์คลไลน์ที่ได้มาจาก data_range (แถวหรือคอลัมน์ขึ้นอยู่กับ is_vertical) ที่วางลงในเซลล์ที่อธิบายโดย location_range. ส่งคืนรูปแบบใหม่ของ SparklineGroup.

add_group 

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

สร้างกลุ่มว่างของประเภทที่ระบุ สปาร์คลไลน์ต้องเพิ่มทีละรายการด้วย group.add_sparkline(...).

คุณสมบัติและการวนซ้ำ

Properties

ตัวอย่างต่อไปนี้เขียนข้อมูลรายได้รายเดือนสำหรับสามภูมิภาคและเพิ่ม sparkline แบบเส้นสำหรับแต่ละแถว.

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

ดูเพิ่มเติม

 ภาษาไทย