Table

aspose-cells-foss đại diện cho các bảng có cấu trúc của Excel (ListObjects) thông qua the Table lớp và the TableCollection có thể truy cập dưới dạng ws.list_objects. Các bảng cung cấp các phạm vi có tên, bộ lọc tự động, hàng tiêu đề và kiểu dáng dải hàng được tích hợp trong định dạng XLSX.

Enumerations: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

Mô tả kiểu dáng trực quan được áp dụng cho bảng (dải màu, làm nổi bật cột đầu tiên/cuối cùng).

Enumerations

TableStyleInfo()

Enumerations

NameTypeAccessDescription
name``ReadGets the name.
display_name``ReadGets the display name.
ref``ReadGets the ref.
has_headers``ReadGets the has headers.
show_totals_row``ReadGets the show totals row.
show_auto_filter``ReadGets the show auto filter.
table_style_info``ReadGets the table style info.
columnslistReadGets the columns.

TableColumn

Mô tả một cột đơn lẻ trong bảng.

Enumerations

TableColumn(col_id: int, name: str)
SignatureDescription
__init__(name: str, ref: str, has_headers: bool)
copy()

Enumerations


Enumerations

Table các đối tượng không được tạo trực tiếp. Sử dụng ws.list_objects.add(...) hoặc ws.list_objects.add_with_range(...).

Enumerations


TableCollection

TableCollection được truy cập như ws.list_objects. Nó quản lý tất cả các bảng có cấu trúc trên một worksheet.

Enumerations

add

ws.list_objects.add(
    start_row: int,
    start_col: int,
    end_row: int,
    end_col: int,
    has_headers: bool = True,
    name: str | None = None
) -> Table

Tạo một bảng trên phạm vi ô đã cho. Tất cả các chỉ mục là 0-based. Nếu nameNone, một tên sẽ được tạo tự động (ví dụ,., "Table1").

add_with_range

ws.list_objects.add_with_range(
    cell_range: str,
    name: str | None = None,
    has_headers: bool = True
) -> Table

Tạo một bảng từ chuỗi phạm vi kiểu A1 (ví dụ,., "A1:D10"). Dễ đọc hơn so với add() cho các phạm vi được mã hoá cứng.

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


Enumerations

Ví dụ sau ghi một bộ dữ liệu tồn kho sản phẩm và chuyển nó thành một bảng Excel có kiểu dáng, kèm dòng tổng cộng.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Inventory"

# Write header and data rows
headers = ["SKU", "Product", "Qty", "Unit Price"]
rows = [
    ["A001", "Widget Alpha", 150, 12.99],
    ["A002", "Widget Beta",   80, 24.50],
    ["A003", "Gadget Gamma",  45, 49.99],
    ["A004", "Gadget Delta",  210, 8.75],
]

for col, h in enumerate(headers):
    ws.cells[0][col].put_value(h)
for row_i, row in enumerate(rows, start=1):
    for col_i, val in enumerate(row):
        ws.cells[row_i][col_i].put_value(val)

# Create a table over A1:D5
table = ws.list_objects.add_with_range("A1:D5", name="InventoryTable")

# Configure style
table.table_style_info.name = "TableStyleMedium9"
table.table_style_info.show_row_stripes = True
table.table_style_info.show_first_column = False
table.table_style_info.show_last_column = False

# Add a totals row with sum on Qty and Unit Price columns
table.show_totals_row = True
table.columns[2].totals_row_function = "sum"    # Qty
table.columns[3].totals_row_function = "sum"    # Unit Price
table.columns[0].totals_row_label = "Total"

wb.save("inventory_table.xlsx")

Xem Thêm

 Tiếng Việt