Working with Tables

टेबल के साथ काम करना

Aspose.Cells FOSS for Java supports Excel tables (also known as ListObjects or आप सेल रेंज से नए तालिकाओं को बना सकते हैं, जांच कर सकते है मौजूदा तालिकाओं, शीर्षक और कुल पंक्तियों को सेट करें, अंतर्निहित टेबल शैलियों का उपयोग करें;, व्यक्तिगत स्तंभों तक पहुंचें, और तालिकाओं को सामान्य रैंकों में वापस परिवर्तित करें. प्राथमिक प्रवेश बिंदु है ListObjectCollection, के माध्यम से पहुंच Worksheet.getListObjects().

Overview

एक कार्यपत्रक पर तालिकाओं को संचालित किया जाता है ListObjectCollection वापस लौटें Worksheet.getListObjects().हर एक ListObject एक Excel टेबल और अपने प्रदर्शनी नाम, टिप्पणी, सेल रेंज सीमाओं, स्तंभ संग्रह, शैली को दर्शाता है सेटिंग्स, और शीर्षक / कुल क्रम दृश्यता।.

एक नया टेबल बनाया गया है ListObjectCollection.add(startRow, startColumn, endRow, endColumn, hasHeaders), जो नए बनाए गए तालिका के शून्य-आधारित सूचकांक को वापस करता है. एक विकल्प अतिरंजित सेल नाम तारों को स्वीकार करता है: ListObjectCollection.add(startCellName, endCellName, hasHeaders).

मुख्य क्लासेस

Class	Description
`ListObject`	एक Excel तालिका का प्रतिनिधित्व करता है. Exposes `getDisplayName()`, `getComment()`, रेंज कोडों, स्तंभ संग्रह, शैली प्रकार और शीर्षक / कुल क्रम दृश्यता।.
`ListObjectCollection`	एक कार्यपत्रक पर सभी तालिकाओं का संग्रह. समर्थन `getCount()`, इंडेक्स और नामित lookup के माध्यम से `get()`, `add()`, `remove()`,और स्टाइल-प्रकार रूपांतरण सहायक।.
`ListColumn`	एक तालिका के भीतर एक स्तंभ का प्रतिनिधित्व करता है. यह स्लाइड आईडी, नाम और कुल-रोआ गणना सेटिंग्स को प्रदर्शित करता हैं.
`ListColumnCollection`	एक तालिका में स्तंभों का आदेश संग्रह. गिनती और सूचकांक एक्सेस के साथ Iterable.
`TableStyleType`	एक अंतर्निहित Excel टेबल शैली (लाइट 1–21, मध्यम 1 – 28, अंधेरे 1-11 या कस्टम / कोई) का पता लगाने के लिए एन्यूम।.
`TotalsCalculation`	एक तालिका की कुल क्रम में संकलित कार्य के लिए एनयूएम (SUM, COUNT, AVERAGE, MAX, MIN, STD_DEV, VAR, CONTAIN_NUMS, CUSTOM, NONE)।.

एक कार्यपत्रक पर तालिकाओं का उपयोग करना

रिटर्न करें 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) शामिल हैं। अधिक विकल्प 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) के बीच में परिवर्तित करें एनाम और इसके स्ट्रिंग प्रतिनिधित्व।.

टेबल कोलन के साथ काम करना

व्यक्तिगत स्तंभों के माध्यम से पहुंच 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());
}

Totals Row सेटअप करें

कुल मिलाकर संभव है ListObject.setShowTotals(true),और फिर सेट करें per-column संतुलन का उपयोग करके कार्यों को पूरा करें 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

Method	वापसी प्रकार	Description
`getDisplayName()`	`String`	टेबल का नाम दिखाएं।.
`setDisplayName(name)`	`void`	प्रदर्शनी का नाम लिखें।.
`getComment()`	`String`	टेबल के लिए वैकल्पिक टिप्पणी।.
`setComment(comment)`	`void`	टेबल पर टिप्पणी करें।.
`getStartRow()`	`int`	तालिका रेंज के क्रम सूचकांक शुरू करें।.
`getStartColumn()`	`int`	तालिका रेंज के स्तंभ सूचकांक शुरू करें।.
`getEndRow()`	`int`	अंतिम क्रम तालिका रेंज के संकेतक।.
`getEndColumn()`	`int`	अंतिम स्तंभ सूचकांक तालिका रेंज के अंत में।.
`isShowHeaderRow()`	`boolean`	क्या शीर्षक पंक्ति दिखाई देती है।.
`setShowHeaderRow(show)`	`void`	शीर्षक की पंक्ति दिखाएं या छिपाएं।.
`isShowTotals()`	`boolean`	यह देखते हुए कि कुल क्रम दिखाई दे रहा है।.
`setShowTotals(show)`	`void`	कुल क्रम को दिखाएं या छिपाएं।.
`getTableStyleType()`	`TableStyleType`	टेबल में बनाया गया स्टाइल।.
`setTableStyleType(type)`	`void`	एक अंतर्निहित टेबल स्टाइल का उपयोग करें।.
`getTableStyleName()`	`String`	टेबल स्टाइल नाम।.
`setTableStyleName(name)`	`void`	एक टेबल स्टाइल नाम सेट करें।.
`getListColumns()`	`ListColumnCollection`	टेबल के स्तंभों की एक संग्रह है।.
`resize(...)`	`void`	टेबल को एक नए रेंज में पुनर्स्थापित करें।.
`convertToRange()`	`void`	टेबल को सामान्य रेंज में परिवर्तित करें।.
`showAutoFilter()`	`void`	ऑटो-फिल्टर लहरों को प्रदर्शित करें।.
`removeAutoFilter()`	`void`	ऑटो-फिल्टर लहरों को छिपाएं।.

ListObjectCollection

Method	वापसी प्रकार	Description
`getCount()`	`int`	कार्यपत्रक पर तालिकाओं की संख्या।.
`get(index)`	`ListObject`	यह तालिका को दिए गए शून्य-आधारित सूचकांक पर वापस करता है।.
`get(name)`	`ListObject`	डिस्प्ले नाम के साथ तालिका को वापस करें।.
`add(startRow, startColumn, endRow, endColumn, hasHeaders)`	`int`	एक नया तालिका बनाता है; इसके सूचकांक को वापस करता है।.
`add(startCellName, endCellName, hasHeaders)`	`int`	सेल नामों से एक नया तालिका बनाता है; इसके सूचकांक को वापस करता है।.
`removeAt(index)`	`void`	उस सूचकांक में तालिका को हटा दें।.
`parseTableStyleType(name)`	`TableStyleType`	एक कोर में बदलना एक `TableStyleType` मूल्य के लिए।.
`tableStyleTypeName(type)`	`String`	A को बदलना `TableStyleType` इसके नाम पर लिंग का एंड्रॉयड।.

ListColumn

Method	वापसी प्रकार	Description
`getId()`	`int`	एक-आधारित OOXML स्तंभ पहचानकर्ता।.
`getName()`	`String`	पाठ का शीर्षक है।.
`setName(name)`	`void`	पाठ का शीर्षक स्तंभ सेट करें।.
`getTotalsCalculation()`	`TotalsCalculation`	कुल क्रम संकलित कार्य है।.
`setTotalsCalculation(calc)`	`void`	कुल क्रम को संकलित करें।.
`getTotalsRowLabel()`	`String`	कुल लाइन में कस्टम लेबल।.
`setTotalsRowLabel(label)`	`void`	कुल लाइन लेबल बनाएं।.
`getTotalsRowFormula()`	`String`	कुल क्रम के लिए अनुकूलित सूत्र।.
`setTotalsRowFormula(formula)`	`void`	कुल क्रम सूत्र बनाएं।.

Limitations

तालिका डेटा बंडल अलग-अलग संशोधित नहीं हैं; तालका अंतर को कवर करता है समय निर्धारित किया गया है. उपयोग करें resize() कवर किए गए क्षेत्र को समायोजित करने के लिए।.
उन्हें संदर्भित करने से पहले कार्यपुस्तिका में अनुकूलित तालिका शैलियों को परिभाषित किया जाना चाहिए नाम के माध्यम से setTableStyleName().

टेबल के साथ काम करना