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, TableColumn

TableStyleInfo

Bir tabloya uygulanan görsel stili (bantlama, ilk/son sütun vurguları) tanımlar.

Enumerations

TableStyleInfo()

Enumerations

NameTypeAccessDescription
name``ReadGets the name.
display_name``ReadGets the display name.
ref``ReadGets the ref.
has_headers``ReadGets the has headers.
show_totals_row``ReadGets the show totals row.
show_auto_filter``ReadGets the show auto filter.
table_style_info``ReadGets the table style info.
columnslistReadGets the columns.

TableColumn

Bir tablo içindeki tek bir sütunu tanımlar.

Enumerations

TableColumn(col_id: int, name: str)
SignatureDescription
__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
) -> Table

Verilen 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
) -> Table

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

Ayrıca Bakınız

 Türkçe