Aspose.Cells FOSS
Python
Sparkline

Sparkline

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.

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

SparklineEmptyCells

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

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

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)

Enumerations

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

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.

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

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