Aspose.Cells FOSS
Python
Table

Table — Aspose.Cells FOSS for Python API Reference

az aspose-cells-foss az Excel strukturált táblákat (ListObjects) a Table osztály és a TableCollection elérhető a ws.list_objects. A táblák névvel ellátott tartományokat, automatikus szűrőt, fejlécsorokat és a XLSX formátumba beépített sávos sorstílust biztosítanak.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

Leírja a táblára alkalmazott vizuális stílust (sávos megjelenítés, első/utolsó oszlop kiemelése).

ImageRenderOptions 

TableStyleInfo()

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrExcel tábla stílus neve (pl., "TableStyleMedium9").
show_first_columnboolTrue az első oszlopra speciális formázás alkalmazásához.
show_last_columnboolTrue az utolsó oszlopra speciális formázás alkalmazásához.
show_row_stripesboolTrue váltakozó sorcsíkozás alkalmazásához.
show_column_stripesboolTrue váltakozó oszlopcsíkozás alkalmazásához.

TableColumn

Leír egyetlen oszlopot egy táblán belül.

ImageRenderOptions 

TableColumn(col_id: int, name: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
col_idint1-based column identifier within the table (not the worksheet column index).
namestrOszlopfejléc szövege. Egyedinek kell lennie a táblán belül.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
idintOszlopazonosító (csak olvasható).
namestrOszlopfejléc szövege.
totals_row_functionstrÖsszesítő függvény, amely a összegző sorban jelenik meg: 'none', 'sum', 'average', 'count', 'countNums', 'max', 'min', 'stdDev', 'var', 'custom'.
totals_row_labelstrCímke szöveg, amely az összegző cellában jelenik meg, amikor totals_row_function van 'none'.
totals_row_formulastrEgyéni képlet, amely akkor használatos, amikor totals_row_function van 'custom'.

ImageRenderOptions

Table az objektumok nem kerülnek közvetlenül létrehozásra. Használja ws.list_objects.add(...) vagy ws.list_objects.add_with_range(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrBelső táblanév (egyedinek kell lennie a munkafüzetben, szóközök nélkül).
display_namestrA megjelenített név az Excel Névmezőben.
refstrA táblázat által lefedett cellatartomány (például,., "A1:D10").
has_headersboolTrue ha a tartomány első sora oszlopfejléceket tartalmaz.
show_totals_rowboolTrue az összesítő összegsor megjelenítéséhez a táblázat alján.
show_auto_filterboolTrue az automatikus szűrő legördülő nyilainak megjelenítéséhez a fejléc sorban.
table_style_infoTableStyleInfoVizuális stílus beállítások (csíkozás, oszlopok kiemelése).
columnslist[TableColumn]Rendezett lista a TableColumn objektumokról (egy a táblázat minden oszlopához).

TableCollection

TableCollection hozzáférhető mint ws.list_objects. Kezeli a munkalapon lévő összes strukturált táblázatot.

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

Létrehoz egy táblázatot a megadott cellatartomány felett. Minden index 0-based. Ha name van None, egy név automatikusan generálódik (például,., "Table1").

add_with_range 

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

Létrehoz egy táblázatot egy A1-stílusú tartománykarakterláncból (például,., "A1:D10"). Olvashatóbb, mint add() hardcoded tartományokhoz.

Tulajdonságok és iteráció

ImageRenderOptionsImageRenderOptions
countA munkalapon lévő táblák száma (csak olvasható).
__len__()ImageRenderOptions count.
__iter__()Végigiterál minden Table objektumok.
__getitem__(index)Visszaadja a Table nulla-alapú index.

ImageRenderOptions

Az alábbi példa egy termékkészlet adatkészletet ír ki, és egy stílusos Excel táblává alakítja, amely tartalmaz egy összegző sort.

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

Lásd még

 Magyar