Cells
Python
Table

Table — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss rappresenta le tabelle strutturate di Excel (ListObjects) attraverso il Table classe e il TableCollection accessibile come ws.list_objects. Le tabelle forniscono intervalli denominati, filtro automatico, righe di intestazione e stile a bande di righe integrato nel formato XLSX.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

Descrive lo stile visivo applicato a una tabella (bande, evidenziazione della prima/ultima colonna).

ImageRenderOptions 

TableStyleInfo()

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrNome dello stile della tabella Excel (ad es., "TableStyleMedium9").
show_first_columnboolTrue per applicare una formattazione speciale alla prima colonna.
show_last_columnboolTrue per applicare una formattazione speciale all’ultima colonna.
show_row_stripesboolTrue per applicare bande alternate alle righe.
show_column_stripesboolTrue per applicare bande alternate alle colonne.

TableColumn

Descrive una singola colonna all’interno di una tabella.

ImageRenderOptions 

TableColumn(col_id: int, name: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
col_idint1-based column identifier within the table (not the worksheet column index).
namestrTesto dell’intestazione della colonna. Deve essere univoco all’interno della tabella.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
idintIdentificatore della colonna (sola lettura).
namestrTesto dell’intestazione della colonna.
totals_row_functionstrFunzione di aggregazione mostrata nella riga dei totali: 'none', 'sum', 'average', 'count', 'countNums', 'max', 'min', 'stdDev', 'var', 'custom'.
totals_row_labelstrTesto dell’etichetta mostrato nella cella dei totali quando totals_row_function è 'none'.
totals_row_formulastrFormula personalizzata utilizzata quando totals_row_function è 'custom'.

ImageRenderOptions

Table gli oggetti non sono costruiti direttamente. Usa ws.list_objects.add(...) oppure ws.list_objects.add_with_range(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrNome interno della tabella (deve essere unico nella cartella di lavoro, senza spazi).
display_namestrNome visualizzato nella casella dei nomi di Excel.
refstrIntervallo di celle coperto dalla tabella (ad es., "A1:D10").
has_headersboolTrue se la prima riga dell’intervallo contiene le intestazioni di colonna.
show_totals_rowboolTrue per visualizzare una riga di totali di aggregazione in fondo alla tabella.
show_auto_filterboolTrue per mostrare le frecce a discesa del filtro automatico nella riga di intestazione.
table_style_infoTableStyleInfoImpostazioni dello stile visivo (alternanza, colonne evidenziate).
columnslist[TableColumn]Elenco ordinato di TableColumn oggetti (uno per colonna della tabella).

TableCollection

TableCollection è accessibile come ws.list_objects. Gestisce tutte le tabelle strutturate in un foglio di lavoro.

ImageRenderOptions

aggiungi 

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

Crea una tabella sull’intervallo di celle specificato. Tutti gli indici sono 0-based. Se name è None, un nome viene generato automaticamente (ad esempio,., "Table1").

add_with_range 

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

Crea una tabella da una stringa di intervallo in stile A1 (ad esempio,., "A1:D10"). Più leggibile di add() per intervalli codificati.

Proprietà e iterazione

ImageRenderOptionsImageRenderOptions
countNumero di tabelle in questo foglio di lavoro (sola lettura).
__len__()ImageRenderOptions count.
__iter__()Itera su tutti i Table oggetti.
__getitem__(index)Restituisce il/la Table a indice basato su zero index.

ImageRenderOptions

Il seguente esempio scrive un dataset di inventario prodotti e lo converte in una tabella Excel stilizzata con una riga dei totali.

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

Vedi anche

 Italiano