Sparkline — Aspose.Cells FOSS for Python API Reference
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, SparklineGroupSparklineType
SparklineType คือ IntEnum ที่ระบุรูปแบบการแสดงผลของกลุ่ม sparkline.
| Properties | Properties | Properties |
|---|---|---|
LINE | 0 | Line sparkline — แสดงข้อมูลเป็นเส้นต่อเนื่อง. |
COLUMN | 1 | Column sparkline — แสดงข้อมูลเป็นแถบแนวตั้ง. |
WIN_LOSS | 2 | Win/loss sparkline — แต่ละค่าจะแสดงเป็นบล็อกบวกหรือบล็อกลบ. |
SparklineEmptyCells
SparklineEmptyCells คือ IntEnum ที่ควบคุมวิธีการจัดการเซลล์ว่างภายใน sparkline.
| Properties | Properties | Properties |
|---|---|---|
ZERO | 0 | ปฏิบัติเช่นเซลล์ว่างเป็นศูนย์. |
GAP | 1 | ทิ้งช่องว่างเมื่อเซลล์ว่าง (เส้นขาด). |
CONNECTED | 2 | เชื่อมค่าที่ไม่ว่างที่อยู่ติดกัน, ข้ามช่องว่าง. |
Properties
A Sparkline ผูกช่วงข้อมูลเดียวกับตำแหน่งเซลล์เดียว.
Properties
Sparkline(data_range: str, cell_reference: str)| Properties | Properties | Properties |
|---|---|---|
data_range | str | ช่วงแบบ A1 ที่มีข้อมูลต้นทางของสปาร์กไลน์ (เช่น,., "Sheet1!B2:G2"). |
cell_reference | str | ที่อยู่เซลล์แบบ A1 ที่สปาร์กไลน์จะแสดง (เช่น,., "H2"). |
Properties
| Properties | Properties | Properties |
|---|---|---|
data_range | str | ช่วงข้อมูลต้นทาง. |
cell_reference | str | ที่อยู่เซลล์ที่แสดง. |
SparklineGroup
A SparklineGroup กำหนดการตั้งค่าภาพรวมที่ใช้ร่วมกัน (ประเภท, สี, การจัดการเซลล์ว่าง) สำหรับชุดของสปาร์คลไลน์. SparklineGroup อ็อบเจกต์ไม่ได้ถูกสร้างโดยตรง — ใช้ ws.sparkline_groups.add(...) หรือ ws.sparkline_groups.add_group(...).
Properties
| Properties | Properties | Properties |
|---|---|---|
type | SparklineType | รูปแบบ Sparkline: LINE, COLUMN, หรือ WIN_LOSS. |
display_empty_cells_as | SparklineEmptyCells | วิธีการจัดการเซลล์ว่างในช่วงข้อมูล. |
color_series | str | สีสำหรับเส้น/แถบหลักของสปาร์คลไลน์, ในรูปแบบรหัส HEX RRGGBB. |
color_negative | str | สีสำหรับแถบค่าติดลบ (WIN_LOSS และ COLUMN), ในรูปแบบรหัส HEX RRGGBB. |
color_axis | str | สีของเส้นแกนศูนย์, ในรูปแบบรหัส HEX RRGGBB. |
color_markers | str | สีของเครื่องหมายจุดข้อมูลบนสปาร์กไลน์แบบเส้น, เป็นรูปแบบ RRGGBB แบบฐานสิบหก. |
color_first | str | สีไฮไลท์สำหรับจุดข้อมูลแรก, เป็นรูปแบบ RRGGBB แบบฐานสิบหก. |
color_last | str | สีไฮไลท์สำหรับจุดข้อมูลสุดท้าย, เป็นรูปแบบ RRGGBB แบบฐานสิบหก. |
color_high | str | สีไฮไลท์สำหรับจุดข้อมูลที่สูงที่สุด, เป็นรูปแบบ RRGGBB แบบฐานสิบหก. |
color_low | str | สีไฮไลท์สำหรับจุดข้อมูลที่ต่ำที่สุด, เป็นรูปแบบ RRGGBB แบบฐานสิบหก. |
sparklines | list[Sparkline] | รายการสปาร์กไลน์แต่ละตัวในกลุ่มนี้แบบอ่านอย่างเดียว. |
count | int | จำนวนสปาร์กไลน์ในกลุ่มนี้ (อ่านอย่างเดียว). |
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.
| Properties | Properties | Properties |
|---|---|---|
sparkline_type | SparklineType | สปาร์คลไลน์ในรูปแบบภาพ. |
data_range | `str | None` |
is_vertical | bool | Properties True, แต่ละคอลัมน์ใน data_range ให้สปาร์คลไลน์หนึ่ง; เมื่อ False, แต่ละแถวทำเช่นนั้น. |
location_range | `str | None` |
add_group
ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroupสร้างกลุ่มว่างของประเภทที่ระบุ สปาร์คลไลน์ต้องเพิ่มทีละรายการด้วย group.add_sparkline(...).
คุณสมบัติและการวนซ้ำ
| Properties | Properties |
|---|---|
count | จำนวนกลุ่มสปาร์คลไลน์ในแผ่นงานนี้ (อ่านอย่างเดียว). |
__len__() | Properties count. |
__iter__() | วนซ้ำผ่านทั้งหมด SparklineGroup วัตถุ. |
__getitem__(index) | ส่งคืน the SparklineGroup ที่เริ่มจากศูนย์ index. |
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")