Table — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss vertegenwoordigt Excel-gestructureerde tabellen (ListObjects) via de Table klasse en de TableCollection toegankelijk als ws.list_objects. Tabellen bieden benoemde bereiken, auto-filter, koprijen en gestreepte-rijopmaak die ingebouwd is in het XLSX-formaat.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

Beschrijft de visuele stijl die op een tabel wordt toegepast (banding, markeringen van eerste/laatste kolom).

ImageRenderOptions

TableStyleInfo()

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrExcel-tabelstijlnamen (bijv., "TableStyleMedium9").
show_first_columnboolTrue om speciale opmaak toe te passen op de eerste kolom.
show_last_columnboolTrue om speciale opmaak toe te passen op de laatste kolom.
show_row_stripesboolTrue om afwisselende rijbanding toe te passen.
show_column_stripesboolTrue om afwisselende kolombanding toe te passen.

TableColumn

Beschrijft een enkele kolom binnen een tabel.

ImageRenderOptions

TableColumn(col_id: int, name: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
col_idint1-based column identifier within the table (not the worksheet column index).
namestrKolomkoptekst. Moet uniek zijn binnen de tabel.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
idintKolomidentificatie (alleen-lezen).
namestrKolomkoptekst.
totals_row_functionstrAggregatiefunctie weergegeven in de totalenrij: 'none', 'sum', 'average', 'count', 'countNums', 'max', 'min', 'stdDev', 'var', 'custom'.
totals_row_labelstrLabeltekst weergegeven in de totalencel wanneer totals_row_function is 'none'.
totals_row_formulastrAangepaste formule gebruikt wanneer totals_row_function is 'custom'.

ImageRenderOptions

Table objecten worden niet direct geconstrueerd. Gebruik ws.list_objects.add(...) of ws.list_objects.add_with_range(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrInterne tabelnaam (moet uniek zijn in de werkmap, geen spaties).
display_namestrWeergavenaam weergegeven in het Excel-naamvak.
refstrHet celbereik dat door de tabel wordt gedekt (bijv., "A1:D10").
has_headersboolTrue als de eerste rij van het bereik kolomkoppen bevat.
show_totals_rowboolTrue om een aggregatie‑totaalrij onderaan de tabel weer te geven.
show_auto_filterboolTrue om de vervolgkeuzepijlen van de automatische filter in de koprij te tonen.
table_style_infoTableStyleInfoVisuele stijlinstellingen (banding, kolommen markeren).
columnslist[TableColumn]Geordende lijst van TableColumn objecten (één per tabelkolom).

TableCollection

TableCollection wordt benaderd als ws.list_objects. Het beheert alle gestructureerde tabellen op een werkblad.

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

Maakt een tabel over het opgegeven celbereik. Alle indexen zijn 0-based. Als name is None, wordt er automatisch een naam gegenereerd (bijv., "Table1").

add_with_range

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

Maakt een tabel aan vanuit een A1-stijl bereikstring (bijv., "A1:D10"). Leesbaarder dan add() voor hardcoded ranges.

Eigenschappen en iteratie

ImageRenderOptionsImageRenderOptions
countAantal tabellen op dit werkblad (alleen-lezen).
__len__()ImageRenderOptions count.
__iter__()Itereert over alle Table objecten.
__getitem__(index)Retourneert de Table bij nulgebaseerde index.

ImageRenderOptions

Het volgende voorbeeld schrijft een productinventaris-dataset en zet deze om in een gestylede Excel-tabel met een totalenrij.

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

Zie ook

 Nederlands