Table

aspose-cells-foss merepresentasikan tabel terstruktur Excel (ListObjects) melalui Table kelas dan TableCollection dapat diakses sebagai ws.list_objects. Tabel menyediakan rentang bernama, penyaring otomatis, baris header, dan gaya baris berpita yang terintegrasi dalam format XLSX.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

Menjelaskan gaya visual yang diterapkan pada tabel (banding, penyorotan kolom pertama/terakhir).

ImageRenderOptions

TableStyleInfo()

ImageRenderOptions

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

Menjelaskan satu kolom dalam sebuah tabel.

ImageRenderOptions

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

ImageRenderOptions


ImageRenderOptions

Table objek tidak dibangun secara langsung. Gunakan ws.list_objects.add(...) atau ws.list_objects.add_with_range(...).

ImageRenderOptions


TableCollection

TableCollection diakses sebagai ws.list_objects. Itu mengelola semua tabel terstruktur pada lembar kerja.

ImageRenderOptions

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

Membuat tabel pada rentang sel yang diberikan. Semua indeks adalah 0-based. Jika name adalah None, nama akan dihasilkan secara otomatis (misalnya,., "Table1").

add_with_range

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

Membuat tabel dari string rentang gaya A1 (misalnya,., "A1:D10"). Lebih mudah dibaca daripada add() untuk rentang yang dikodekan secara keras.

Properti dan Iterasi


ImageRenderOptions

Contoh berikut menulis dataset inventaris produk dan mengubahnya menjadi tabel Excel yang bergaya dengan baris total.

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

Lihat Juga

 Bahasa Indonesia