Table

Table — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss predstavlja strukturirane tabele u Excelu (ListObjects) kroz Table klasu i TableCollection dostupan kao ws.list_objects. Tabele pružaju imenovane opsege, automatski filter, zaglavlja redova i stilizovanje redova u trakama ugrađeno u XLSX format.

: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

Opisuje vizuelni stil primenjen na tabelu (trake, isticanje prve/poslednje kolone).

TableStyleInfo()


`name`	`str`	Naziv stila Excel tabele (npr., `"TableStyleMedium9"`).
`show_first_column`	`bool`	`True` za primenu posebnog formatiranja na prvu kolonu.
`show_last_column`	`bool`	`True` za primenu posebnog formatiranja na poslednju kolonu.
`show_row_stripes`	`bool`	`True` za primenu naizmeničnog obeležavanja redova.
`show_column_stripes`	`bool`	`True` za primenu naizmeničnog obojavanja kolona.

TableColumn

Opisuje pojedinačnu kolonu unutar tabele.

TableColumn(col_id: int, name: str)


`col_id`	`int`	1-based column identifier within the table (not the worksheet column index).
`name`	`str`	Tekst zaglavlja kolone. Mora biti jedinstven unutar tabele.


`id`	`int`	Identifikator kolone (samo za čitanje).
`name`	`str`	Tekst zaglavlja kolone.
`totals_row_function`	`str`	Agregatna funkcija prikazana u redu sa ukupnim vrednostima: `'none'`, `'sum'`, `'average'`, `'count'`, `'countNums'`, `'max'`, `'min'`, `'stdDev'`, `'var'`, `'custom'`.
`totals_row_label`	`str`	Tekst oznake prikazan u ćeliji sa ukupnim vrednostima kada `totals_row_function` je `'none'`.
`totals_row_formula`	`str`	Prilagođena formula koja se koristi kada `totals_row_function` je `'custom'`.

Table objekti se ne konstrušu direktno. Koristite ws.list_objects.add(...) ili ws.list_objects.add_with_range(...).


`name`	`str`	Interni naziv tabele (mora biti jedinstven u radnoj svesci, bez razmaka).
`display_name`	`str`	Naziv prikazan u Excel Name Box‑u.
`ref`	`str`	Opseg ćelija koji obuhvata tabela (npr., `"A1:D10"`).
`has_headers`	`bool`	`True` ako prvi red opsega sadrži zaglavlja kolona.
`show_totals_row`	`bool`	`True` za prikazivanje reda sa agregiranim ukupcima na dnu tabele.
`show_auto_filter`	`bool`	`True` da prikaže strelice padajućeg menija automatskog filtera u zaglavlju reda.
`table_style_info`	`TableStyleInfo`	Podešavanja vizuelnog stila (prugovanje, isticanje kolona).
`columns`	`list[TableColumn]`	Uređeni spisak `TableColumn` objekata (po jedan po koloni tabele).

TableCollection

TableCollection se pristupa kao ws.list_objects. Upravlja svim strukturiranim tabelama na radnom listu.

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

Kreira tabelu nad zadatim opsegom ćelija. Svi indeksi su 0-based. Ako name je None, ime se generiše automatski (npr., "Table1").

add_with_range

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

Kreira tabelu iz A1‑stila niza opsega (npr., "A1:D10"). Čitljivije od add() za hardkodirane opsege.

Svojstva i iteracija


`count`	Broj tabela na ovom radnom listu (samo za čitanje).
`__len__()`	`count`.
`__iter__()`	Iterira kroz sve `Table` objekte.
`__getitem__(index)`	Vraća `Table` na nultom `index`.

Sledeći primer upisuje skup podataka o inventaru proizvoda i pretvara ga u stilizovanu Excel tabelu sa redom za ukupne vrednosti.

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