کار با میزها

کار با میزها

Aspose.Cells FOSS for Java supports Excel tables (also known as ListObjects or شما می توانید جدول های جدید را از ردیف سلول ها ایجاد کنید، بررسی کنید. جدول های موجود، تنظیم عنوان و ردیف کل، استفاده از سبک های جدول ساخته شده،, دسترسی به ستون های فردی، و تبدیل جدول به سطوح عادی. نقطه ورودی ListObjectCollection,دسترسی از طریق Worksheet.getListObjects().

Overview

در یک صفحه کار از طریق یک ListObjectCollection بازگشت به Worksheet.getListObjects().هر کدام ListObject یک جدول اکسل را نشان می دهد و نمایش نام، نظر، محدوده سلول، مجموعه ستون، سبک تنظیمات و سر / کل ردیف بینایی.

یک میز جدید با ListObjectCollection.add(startRow, startColumn, endRow, endColumn, hasHeaders), که شاخص مبتنی بر صفر را از جدول تازه ایجاد شده باز می گرداند. اضافه وزن سلول نام خطوط را می پذیرد: ListObjectCollection.add(startCellName, endCellName, hasHeaders).

کلاس‌های کلیدی

دسترسی به جدول ها در یک ورودی

بازگرداندن آن ListObjectCollection از هر Worksheet از طریق Worksheet.getListObjects().استفاده از ListObjectCollection.getCount() برای تعیین تعداد جدول ها وجود دارد.تعداد های فردی از طریق شاخص مبتنی بر صفر به دست می آید ListObjectCollection.get(index) یا نام را از طریق ListObjectCollection.get(name).

Workbook wb = new Workbook("input.xlsx");
WorksheetCollection sheets = wb.getWorksheets();
Worksheet ws = sheets.get(0);
ListObjectCollection tables = ws.getListObjects();

for (int i = 0; i < tables.getCount(); i++) {
    ListObject table = tables.get(i);
    System.out.println("Table: " + table.getDisplayName()
        + " rows: " + table.getStartRow() + "-" + table.getEndRow());
}

ایجاد یک میز جدید

استفاده از ListObjectCollection.add() برای قرار دادن یک جدول در محدوده سلولی. hasHeaders پارامتر نشان می دهد که آیا خط اول محدوده شامل سرگزاران ستون ها.

Workbook wb = new Workbook();
WorksheetCollection sheets = wb.getWorksheets();
Worksheet ws = sheets.get(0);

// Populate data
ws.getCells().get("A1").putValue("Product");
ws.getCells().get("B1").putValue("Quantity");
ws.getCells().get("A2").putValue("Widget");
ws.getCells().get("B2").putValue(100);

// Create table over A1:B2 with headers in row 0
int tableIndex = ws.getListObjects().add(0, 0, 1, 1, true);
ListObject table = ws.getListObjects().get(tableIndex);
table.setDisplayName("SalesTable");

بررسی ویژگی های میز

وقتی شما یک ListObject مرجع شما می توانید بخوانید:

• ListObject.getDisplayName() - نام شاخص میز را نشان می دهد.
• ListObject.getComment() - یک نظر اختیاری مرتبط با جدول.
• ListObject.getStartRow() / ListObject.getStartColumn() - سلول سمت چپ بالای محدوده میز.
• ListObject.getEndRow() / ListObject.getEndColumn() - سلول سمت راست پایین محدوده میز.
• ListObject.isShowHeaderRow() آیا خط سر قابل مشاهده است یا نه.
• ListObject.isShowTotals() آیا خط کل قابل مشاهده است یا نه.
• ListObject.getListColumns() - این ListColumnCollection برای میز.

جدول های سبک

استفاده از یک میز با استفاده ListObject.setTableStyleType(TableStyleType). و این TableStyleType این شامل نور (1–21)، متوسط (1 – 28) و تاریک (1-11) است. گزینه های Plus NONE و CUSTOM.

ListObject table = ws.getListObjects().get(0);
table.setTableStyleType(TableStyleType.TABLE_STYLE_MEDIUM_2);

سبک اضافی کنترل ردیف های بسته بندی، ستون های متصل و تاکید اول / آخر ستون:

• ListObject.setShowTableStyleRowStripes(boolean)
• ListObject.setShowTableStyleColumnStripes(boolean)
• ListObject.setShowTableStyleFirstColumn(boolean)
• ListObject.setShowTableStyleLastColumn(boolean)

شما همچنین می توانید یک نام سبک سفارشی با ListObject.setTableStyleName(String).

روش های کمک کننده ListObjectCollection.parseTableStyleType(String) و ListObjectCollection.tableStyleTypeName(TableStyleType) تبدیل بین Enum و نمایندگی آن است.

کار با ستون های میز

دسترسی به ستون های فردی از طریق ListObject.getListColumns(),که به یک بازگشت می رسد. ListColumnCollection.هر کدام ListColumn نمایش ها :

• ListColumn.getId() – شناسه ستون OOXML یک پایه.
• ListColumn.getName() / ListColumn.setName(String) - عنوان متن ستون را انتخاب کنید.
• ListColumn.getTotalsCalculation() / ListColumn.setTotalsCalculation(TotalsCalculation) - عملکرد جمع آوری برای کل ردیف.
• ListColumn.getTotalsRowLabel() / ListColumn.setTotalsRowLabel(String) - یک برچسب سفارشی در ردیف کل.
• ListColumn.getTotalsRowFormula() / ListColumn.setTotalsRowFormula(String) - فرمول سفارشی برای کل ردیف.

ListObject table = ws.getListObjects().get(0);
ListColumnCollection columns = table.getListColumns();
for (int i = 0; i < columns.getCount(); i++) {
    ListColumn col = columns.get(i);
    System.out.println("Column " + col.getId() + ": " + col.getName());
}

تنظیم کلینیک را انتخاب کنید

امکان پذیر است که کل خط با ListObject.setShowTotals(true),سپس برای هر ستون تنظیم کنید. عملکردهای جمع آوری با استفاده از TotalsCalculation امی.

ListObject table = ws.getListObjects().get(0);
table.setShowTotals(true);

ListColumn qtyColumn = table.getListColumns().get(1);
qtyColumn.setTotalsCalculation(TotalsCalculation.SUM);

ListColumn labelColumn = table.getListColumns().get(0);
labelColumn.setTotalsRowLabel("Total");

بازسازی و تبدیل جدول ها

یک میز را برای پوشش طیف سلولی متفاوت با استفاده از ListObject.resize(startRow, startColumn, endRow, endColumn, hasHeaders).

تبدیل یک میز به محدوده سلولی عادی با ListObject.convertToRange(). این ساختار جدول را در حالی که حفظ داده های سلولی و فرمت حذف می کند.

یک میز را به طور کامل از مجموعه حذف کنید. ListObjectCollection.removeAt(index).

فیلترهای خودکار روی میز

نمایش یا حذف ستون پایین خود فیلتر شلیک در یک جدول:

• ListObject.showAutoFilter() - نمایش فیلترهای بر روی خط سر.
• ListObject.removeAutoFilter() – پنهان کردن فیلترهای شلیک شده.

API خلاصه ای از ارجاعات

ListObject

ListObjectCollection

ListColumn

Limitations

• اتصالات داده های جدول به صورت جداگانه قابل تغییر نیست؛ جدول شامل محدوده زمان استفاده از آن در زمان ایجاد آن مشخص شده است. resize() برای تنظیم محدوده پوشش داده شده.
• سبک های سفارشی باید قبل از اشاره به آنها در دفتر کار تعریف شوند. نام از طریق setTableStyleName().

See Also

• Aspose.Cells for Java — Enterprise Documentation