Working with Tables

Asztali munkavégzés

Aspose.Cells FOSS for Java supports Excel tables (also known as ListObjects or Új táblázatokat hozhat létre a cellák tartományából, ellenőrizheti az alábbiakat: a meglévő táblázatok, a fejlet és az összes sor konfigurálása, beépített táblás stílusok alkalmazása;, Az elsődleges elemek a következők: a belépési pont: ListObjectCollection, a WEB-en keresztül elérhető. Worksheet.getListObjects().

Overview

A táblázatokat a munkalapon az alábbiakban kezeljük: ListObjectCollection visszaadta: Worksheet.getListObjects().- Mindenki. ListObject egy Excel-táblát képviseli, és feltárja a kijelző nevét, megjegyzését, cellák határait, oszlopok gyűjteményét és stílusát. a beállításokat, valamint a fejléc/összesek sorának láthatóságát.

Új táblázat létrehozása a következővel: ListObjectCollection.add(startRow, startColumn, endRow, endColumn, hasHeaders), amely az újonnan létrehozott táblázat nullás indexét adja vissza. Egy alternatívát a következőkben találjuk: Túlterhelés fogadja a cellanavszövegeket: ListObjectCollection.add(startCellName, endCellName, hasHeaders).

Kulcsosztályok

Class	Description
`ListObject`	Egyetlen Excel-táblát képviseli. `getDisplayName()`, `getComment()`, kör koordináták, oszlopok gyűjtése, stílustípus és fejlet/összes sor láthatósága.
`ListObjectCollection`	A munkalap összes táblázatának gyűjteménye. Támogató elemek `getCount()`, indexált és névleges keresés a WEB-en keresztül. `get()`, `add()`, `remove()`, és stílus-típusú átalakítási segédeszközök.
`ListColumn`	Egy táblázat egy oszlopát jelöli. A oszlopa azonosítója, neve és a teljes sorok számításának beállításai feltüntethetők.
`ListColumnCollection`	A táblázatban sorrendelt oszlopok gyűjteménye. Iterálható számláló és index hozzáféréssel.
`TableStyleType`	A beépített Excel-táblás stílus azonosító Enum (Light 121, Medium 1 ??28, Dark 1 11, vagy Custom/None).
`TotalsCalculation`	A táblázat összesített sorában található összességfunkció (SUMMÁL, TÉTELEM, ÁVASZÍRAT, MAX, MIN, STD_DEV, VAR, COUNT_NUMS, CUSTOM, NONE) számának száma.

A táblázatok elérése munkalapon

Vissza a… ListObjectCollection bármelyikből. Worksheet a következők: Worksheet.getListObjects().Használja. ListObjectCollection.getCount() meghatározása. Az egyes táblázatokhoz a nullázott index segítségével férhetünk hozzá. ListObjectCollection.get(index) vagy a megjelenítési név útján 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());
}

Új asztal létrehozása

Használat ListObjectCollection.add() A táblázat beillesztése egy cellás tartományon. hasHeaders paraméter jelzi, hogy a tartomány első sorában van-e: oszlopfejek.

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

A táblázat tulajdonságainak ellenőrzése

Ha egyszer elkapsz egy… ListObject hivatkozás, amit olvashat:

ListObject.getDisplayName() az asztal megjelenítési névszövege.
ListObject.getComment() a táblázathoz kapcsolódó opcionális megjegyzés.
ListObject.getStartRow() / ListObject.getStartColumn() A táblázat felső bal részén lévő cellája.
ListObject.getEndRow() / ListObject.getEndColumn() Az asztal tartományának jobb alsó cellája.
ListObject.isShowHeaderRow() a címsor látható-e.
ListObject.isShowTotals() a teljes számok sorának látható-e.
ListObject.getListColumns() a ListColumnCollection Az asztalhoz.

Színezőasztal

Beépített táblázat- stílus alkalmazása a következők segítségével: ListObject.setTableStyleType(TableStyleType). A Bizottság TableStyleType az enum tartalmazza a Light (121), Medium (1 ??28) és Dark (1 11) változatok plusz NONE és a következők: CUSTOM.

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

További stílusváltók irányítják a sávos sorokat, az oszlopokat és az első/utolsó oszlopa hangsúlyozását:

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

Egyéni stílusnevet is beállíthat a ListObject.setTableStyleName(String).

Segítő módszerek ListObjectCollection.parseTableStyleType(String) és a következők: ListObjectCollection.tableStyleTypeName(TableStyleType) átváltva a enum és a szalagképzése.

Asztali oszlopokkal való munka

Az egyes oszlopok elérése a ListObject.getListColumns(), ami a ListColumnCollection.- Mindenki. ListColumn a következőket mutatja be:

ListColumn.getId() az OOXML-részeg azonosító.
ListColumn.getName() / ListColumn.setName(String) a oszlopfejtő szöveg.
ListColumn.getTotalsCalculation() / ListColumn.setTotalsCalculation(TotalsCalculation) a teljes számok sorának összesítési funkciója.
ListColumn.getTotalsRowLabel() / ListColumn.setTotalsRowLabel(String) egyéni címke a teljes számok sorában.
ListColumn.getTotalsRowFormula() / ListColumn.setTotalsRowFormula(String) egy egyedi képlet a teljes számok sorához.

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());
}

A teljes sor konfigurálása

A totális sorok engedélyezése a következővel: ListObject.setShowTotals(true), majd oszloponként beállítva . az aggregációs funkciók felhasználásával. TotalsCalculation - Nem, nem.

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

Táblák méretének átalakítása és átállítása

A táblázat méretének megváltoztatása egy másik cellát tartalmazó tartományban a következők segítségével: ListObject.resize(startRow, startColumn, endRow, endColumn, hasHeaders).

A táblázat normál cellákba való átalakítása: ListObject.convertToRange(). Ez eltávolítja az asztal szerkezetét, miközben megőrzi a cellák adatait és formázását.

Egy táblázatot teljesen eltávolítani a gyűjteményből azzal, hogy: ListObjectCollection.removeAt(index).

Autószűrő az asztalon

A táblázatban a oszlopok lecsukható automatikus szűrő nyílának megjelenítése vagy eltávolítása:

ListObject.showAutoFilter() A címsorban a szűrő nyílokat jelenítse meg.
ListObject.removeAutoFilter() A szűrő nyílokat elrejteni.

API-referencia összefoglaló

ListObject

Method	Visszaadási típus	Description
`getDisplayName()`	`String`	A táblázat neve.
`setDisplayName(name)`	`void`	A kijelző nevet állítja be.
`getComment()`	`String`	Az asztalhoz való választható megjegyzés.
`setComment(comment)`	`void`	A táblázat kommentjeit.
`getStartRow()`	`int`	A táblázat tartományának kezdő sorindexje.
`getStartColumn()`	`int`	A táblázat tartományának kezdő oszlopindexje.
`getEndRow()`	`int`	A táblázat tartományának végsorindex.
`getEndColumn()`	`int`	A táblázat tartományának végső oszlopindexje.
`isShowHeaderRow()`	`boolean`	Az, hogy a címsor látható-e.
`setShowHeaderRow(show)`	`void`	Megmutatja vagy elrejti a címsorot.
`isShowTotals()`	`boolean`	Az összes szám sor látható-e.
`setShowTotals(show)`	`void`	Megmutatja vagy elrejti a teljes számok sorát.
`getTableStyleType()`	`TableStyleType`	A beépített asztal stílusú.
`setTableStyleType(type)`	`void`	Beépített asztal stílus.
`getTableStyleName()`	`String`	Kastóasztal stílusnév.
`setTableStyleName(name)`	`void`	Egyéni táblázatstíl nevet állít.
`getListColumns()`	`ListColumnCollection`	Az asztal oszlopok gyűjteménye.
`resize(...)`	`void`	Új méretű asztal.
`convertToRange()`	`void`	A táblázatot normál tartományba alakítja.
`showAutoFilter()`	`void`	Az automatikus szűrő nyílokat mutatja.
`removeAutoFilter()`	`void`	A automatikus szűrő nyílokat rejti el.

ListObjectCollection

Method	Visszaadási típus	Description
`getCount()`	`int`	A munkalap táblázatainak száma.
`get(index)`	`ListObject`	Az adott nullázású indexben adja vissza a táblázatot.
`get(name)`	`ListObject`	Az adott megjelenítési névvel megadott táblázatot adja vissza.
`add(startRow, startColumn, endRow, endColumn, hasHeaders)`	`int`	Új táblázatot hoz létre, az indexét adja vissza.
`add(startCellName, endCellName, hasHeaders)`	`int`	Új táblázatot hoz létre a cellanazonokból; az indexét adja vissza.
`removeAt(index)`	`void`	Eltisztítja a táblázatot az adott indexnél.
`parseTableStyleType(name)`	`TableStyleType`	A sztringet a `TableStyleType` enum érték.
`tableStyleTypeName(type)`	`String`	Átalakítja a `TableStyleType` a szalagnévhez.

ListColumn

Method	Visszaadási típus	Description
`getId()`	`int`	Egy alapú OOXML oszlop azonosító.
`getName()`	`String`	A oszlopfejtő szöveg.
`setName(name)`	`void`	A oszlopfülke szövegét adja.
`getTotalsCalculation()`	`TotalsCalculation`	A teljes számok soragregációs funkciója.
`setTotalsCalculation(calc)`	`void`	A totális sor összesítését állítja be.
`getTotalsRowLabel()`	`String`	A teljes szám sorában egyéni címke.
`setTotalsRowLabel(label)`	`void`	A totális sor címkét adja.
`getTotalsRowFormula()`	`String`	A teljes számok sorának egyedi képlete.
`setTotalsRowFormula(formula)`	`void`	A totális sor képletét adja.

Limitations

A táblázatban szereplő adatok kötése nem módosítható külön; a tábla az alábbi tartományt foglalja magában: A létrehozás időpontjában megadott. resize() a lefedett tartomány beállítása.
A munkaműkönyvben a személyre szabott táblázatstílusokat kell meghatározni, mielőtt hivatkoznánk rájuk. név szerint: via setTableStyleName().

Asztali munkavégzés