Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines là các biểu đồ thu nhỏ được nhúng trong các ô riêng lẻ, được giới thiệu trong Excel 2010. aspose-cells-foss quản lý sparklines thông qua SparklineGroup và SparklineGroupCollection (ws.sparkline_groups). Mỗi nhóm chứa một hoặc nhiều Sparkline đối tượng chia sẻ cùng kiểu và cài đặt màu.

Enumerations: aspose.cells_foss

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

SparklineType

SparklineType là một IntEnum xác định dạng hình ảnh của một nhóm sparkline.

EnumerationsEnumerationsEnumerations
LINE0Sparkline dạng đường — hiển thị dữ liệu dưới dạng một đường nối.
COLUMN1Sparkline dạng cột — hiển thị dữ liệu dưới dạng các thanh dọc.
WIN_LOSS2Sparkline thắng/thua — mỗi giá trị được hiển thị dưới dạng khối dương hoặc âm.

SparklineEmptyCells

SparklineEmptyCells là một IntEnum điều khiển cách các ô trống được xử lý trong một sparkline.

EnumerationsEnumerationsEnumerations
ZERO0Xem các ô trống như là số 0.
GAP1Để lại khoảng trống ở những ô trống (đường bị ngắt).
CONNECTED2Kết nối các giá trị không trống liền kề, bỏ qua khoảng trống.

Enumerations

Một Sparkline ràng buộc một phạm vi dữ liệu duy nhất với một vị trí ô duy nhất.

Enumerations 

Sparkline(data_range: str, cell_reference: str)
EnumerationsEnumerationsEnumerations
data_rangestrPhạm vi kiểu A1 chứa dữ liệu nguồn của sparkline (ví dụ,., "Sheet1!B2:G2").
cell_referencestrĐịa chỉ ô kiểu A1 nơi sparkline được hiển thị (ví dụ,., "H2").

Enumerations

EnumerationsEnumerationsEnumerations
data_rangestrPhạm vi dữ liệu nguồn.
cell_referencestrĐịa chỉ ô hiển thị.

SparklineGroup

A SparklineGroup định nghĩa các cài đặt hiển thị chung (loại, màu sắc, cách xử lý ô trống) cho một tập hợp các sparkline. SparklineGroup các đối tượng không được tạo trực tiếp — sử dụng ws.sparkline_groups.add(...) hoặc ws.sparkline_groups.add_group(...).

Enumerations

EnumerationsEnumerationsEnumerations
typeSparklineTypeBiểu mẫu Sparkline: LINE, COLUMN, hoặc WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsCách xử lý các ô trống trong phạm vi dữ liệu.
color_seriesstrMàu cho đường/đồ thị chính của sparkline, dạng thập lục phân RRGGBB.
color_negativestrMàu cho các thanh có giá trị âm (WIN_LOSS và COLUMN), dạng thập lục phân RRGGBB.
color_axisstrMàu của đường trục zero, dạng thập lục phân RRGGBB.
color_markersstrMàu của các dấu đánh dấu điểm dữ liệu trên sparkline dạng đường, dạng thập lục phân RRGGBB.
color_firststrMàu nổi bật cho điểm dữ liệu đầu tiên, dạng thập lục phân RRGGBB.
color_laststrMàu nổi bật cho điểm dữ liệu cuối cùng, dạng thập lục phân RRGGBB.
color_highstrMàu nổi bật cho điểm dữ liệu cao nhất, dạng thập lục phân RRGGBB.
color_lowstrMàu nổi bật cho điểm dữ liệu thấp nhất, dạng thập lục phân RRGGBB.
sparklineslist[Sparkline]Danh sách chỉ đọc các sparkline riêng lẻ trong nhóm này.
countintSố lượng sparklines trong nhóm này (chỉ đọc).

Enumerations

add_sparkline 

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

Thêm một sparkline riêng lẻ vào nhóm này và trả về mới Sparkline object.

SparklineGroupCollection

SparklineGroupCollection được truy cập như ws.sparkline_groups. Nó chứa tất cả các nhóm sparkline trên một bảng tính.

Enumerations

add 

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

Tạo một nhóm mới và tùy chọn điền nó bằng các sparkline được tạo từ data_range (các hàng hoặc cột tùy thuộc vào is_vertical) được đặt vào các ô được mô tả bởi location_range. Trả về đối tượng mới SparklineGroup.

EnumerationsEnumerationsEnumerations
sparkline_typeSparklineTypeDạng hiển thị của các sparkline.
data_range`strNone`
is_verticalboolEnumerations True, mỗi cột trong data_range cung cấp một sparkline; khi False, mỗi hàng làm như vậy.
location_range`strNone`

add_group 

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

Tạo một nhóm trống của loại đã cho. Các sparkline phải được thêm riêng lẻ bằng group.add_sparkline(...).

Thuộc tính và Lặp lại

EnumerationsEnumerations
countSố lượng nhóm sparkline trên bảng tính này (chỉ đọc).
__len__()Enumerations count.
__iter__()Lặp lại qua tất cả SparklineGroup đối tượng.
__getitem__(index)Trả về SparklineGroup ở chỉ số bắt đầu từ 0 index.

Enumerations

Ví dụ sau ghi dữ liệu doanh thu hàng tháng cho ba khu vực và thêm một sparkline dạng line cho mỗi hàng.

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

Xem Thêm

 Tiếng Việt