Table — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss Excel संरचित तालिकाओं (ListObjects) को के माध्यम से दर्शाता है Table क्लास और TableCollection के रूप में उपलब्ध ws.list_objects. तालिकाएँ नामित रेंज, ऑटो‑फ़िल्टर, हेडर पंक्तियाँ, और बैंडेड‑रो स्टाइलिंग प्रदान करती हैं जो XLSX फ़ॉर्मेट में निर्मित है।.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import TableStyleInfo, TableColumn

TableStyleInfo

एक तालिका पर लागू दृश्य शैली का वर्णन करता है (बैंडिंग, प्रथम/अंतिम कॉलम हाइलाइट)।.

ImageRenderOptions

TableStyleInfo()

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrExcel तालिका शैली का नाम (उदाहरण के लिए,., "TableStyleMedium9").
show_first_columnboolTrue पहले कॉलम पर विशेष फ़ॉर्मेटिंग लागू करने के लिए।.
show_last_columnboolTrue अंतिम कॉलम पर विशेष फ़ॉर्मेटिंग लागू करने के लिए।.
show_row_stripesboolTrue वैकल्पिक पंक्ति बैंडिंग लागू करने के लिए।.
show_column_stripesboolTrue वैकल्पिक कॉलम बैंडिंग लागू करने के लिए।.

TableColumn

एक तालिका के भीतर एकल कॉलम का वर्णन करता है।.

ImageRenderOptions

TableColumn(col_id: int, name: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
col_idint1-based column identifier within the table (not the worksheet column index).
namestrकॉलम हेडर टेक्स्ट। तालिका के भीतर अद्वितीय होना चाहिए।.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
idintकॉलम पहचानकर्ता (केवल‑पढ़ने योग्य)।.
namestrकॉलम हेडर टेक्स्ट।.
totals_row_functionstrकुल पंक्ति में दिखाया गया एग्रीगेट फ़ंक्शन: 'none', 'sum', 'average', 'count', 'countNums', 'max', 'min', 'stdDev', 'var', 'custom'.
totals_row_labelstrजब कुल सेल में लेबल टेक्स्ट दिखाया जाता है totals_row_function है 'none'.
totals_row_formulastrकस्टम फ़ॉर्मूला उपयोग किया जाता है जब totals_row_function है 'custom'.

ImageRenderOptions

Table ऑब्जेक्ट्स सीधे निर्मित नहीं होते हैं। उपयोग करें ws.list_objects.add(...) या ws.list_objects.add_with_range(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrआंतरिक तालिका नाम (वर्कबुक में अद्वितीय होना चाहिए, कोई स्पेस नहीं)।.
display_namestrExcel नाम बॉक्स में दिखाया गया प्रदर्शित नाम।.
refstrतालिका द्वारा कवर किया गया सेल रेंज (उदाहरण के लिए,., "A1:D10").
has_headersboolTrue यदि रेंज की पहली पंक्ति में कॉलम हेडर होते हैं।.
show_totals_rowboolTrue तालिका के नीचे एग्रीगेशन टोटल्स पंक्ति दिखाने के लिए।.
show_auto_filterboolTrue हेडर पंक्ति में ऑटो‑फ़िल्टर ड्रॉपडाउन तीर दिखाने के लिए।.
table_style_infoTableStyleInfoविज़ुअल स्टाइल सेटिंग्स (बैंडिंग, कॉलम हाइलाइट)।.
columnslist[TableColumn]क्रमबद्ध सूची TableColumn ऑब्जेक्ट्स (प्रत्येक तालिका कॉलम के लिए एक)।.

TableCollection

TableCollection को इस रूप में एक्सेस किया जाता है ws.list_objects. यह वर्कशीट पर सभी संरचित तालिकाओं का प्रबंधन करता है।.

ImageRenderOptions

जोड़ें

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

दिए गए सेल रेंज पर एक तालिका बनाता है। सभी इंडेक्स हैं 0-based. यदि name है None, एक नाम स्वचालित रूप से उत्पन्न किया जाता है (उदाहरण के लिए,., "Table1").

add_with_range

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

A1‑शैली की रेंज स्ट्रिंग से तालिका बनाता है (उदाहरण के लिए,., "A1:D10"). से अधिक पठनीय add() हार्डकोडेड रेंजों के लिए।.

गुणधर्म और पुनरावृत्ति

ImageRenderOptionsImageRenderOptions
countइस कार्यपत्रक पर तालिकाओं की संख्या (केवल‑पढ़ने योग्य)।.
__len__()ImageRenderOptions count.
__iter__()सभी पर इटररेट करता है Table ऑब्जेक्ट्स।.
__getitem__(index)वापस देता है Table शून्य‑आधारित पर index.

ImageRenderOptions

निम्नलिखित उदाहरण एक उत्पाद इन्वेंटरी डेटासेट लिखता है और उसे कुल पंक्ति के साथ एक स्टाइल्ड Excel तालिका में परिवर्तित करता है।.

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

संबंधित देखें

 हिन्दी