Table
aspose-cells-foss, Excel yapılandırılmış tablolarını (ListObjects) aracılığıyla temsil eder Table sınıf ve TableCollection olarak erişilebilir ws.list_objects. Tablolar, XLSX formatına yerleşik adlandırılmış aralıklar, otomatik filtre, başlık satırları ve şeritli satır stilini sağlar.
Enumerations: aspose.cells_foss
from aspose.cells_foss import TableStyleInfo, TableColumnTableStyleInfo
Bir tabloya uygulanan görsel stili (bantlama, ilk/son sütun vurguları) tanımlar.
Enumerations
TableStyleInfo()Enumerations
| Name | Type | Access | Description |
|---|---|---|---|
name | `` | Read | Gets the name. |
display_name | `` | Read | Gets the display name. |
ref | `` | Read | Gets the ref. |
has_headers | `` | Read | Gets the has headers. |
show_totals_row | `` | Read | Gets the show totals row. |
show_auto_filter | `` | Read | Gets the show auto filter. |
table_style_info | `` | Read | Gets the table style info. |
columns | list | Read | Gets the columns. |
TableColumn
Bir tablo içindeki tek bir sütunu tanımlar.
Enumerations
TableColumn(col_id: int, name: str)| Signature | Description |
|---|---|
__init__(name: str, ref: str, has_headers: bool) | |
copy() |
Enumerations
Enumerations
Table nesneler doğrudan oluşturulmaz. Kullan: ws.list_objects.add(...) veya ws.list_objects.add_with_range(...).
Enumerations
TableCollection
TableCollection şu şekilde erişilir ws.list_objects. Çalışma sayfasındaki tüm yapılandırılmış tabloları yönetir.
Enumerations
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
) -> TableVerilen hücre aralığı üzerinde bir tablo oluşturur. Tüm indeksler 0-based. Eğer name şu ise None, bir ad otomatik olarak oluşturulur (örneğin,., "Table1").
add_with_range
ws.list_objects.add_with_range(
cell_range: str,
name: str | None = None,
has_headers: bool = True
) -> TableA1 biçimindeki bir aralık dizesinden tablo oluşturur (örneğin,., "A1:D10"). Daha okunaklı add() kod içinde sabitlenmiş aralıklar için.
Özellikler ve Yineleme
Enumerations
Aşağıdaki örnek bir ürün envanter veri kümesini yazar ve bunu toplam satırı içeren stilize bir Excel tablosuna dönüştürür.
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")