Spravovat tabulky prezentací v Androidu
Úvod
Tabulka v PowerPointu je efektivní způsob, jak zobrazit a představit informace. Informace v mřížce buněk (uspořádaných v řádcích a sloupcích) jsou přehledné a snadno pochopitelné.
Aspose.Slides poskytuje třídu Table, rozhraní ITable, třídu Cell , rozhraní ICell a další typy, které umožňují vytvářet, aktualizovat a spravovat tabulky v různých prezentacích.
Vytvoření tabulky od začátku
- Vytvořte instanci třídy Presentation.
- Získejte odkaz na snímek pomocí jeho indexu.
- Definujte pole
columnWidth. - Definujte pole
rowHeight. - Přidejte objekt ITable na snímek pomocí metody addTable.
- Procházejte každou ICell a aplikujte formátování na horní, spodní, pravý a levý okraj.
- Spojte první dvě buňky v první řadě tabulky.
- Přistupte k TextFrame buňky ICell.
- Přidejte nějaký text do TextFrame.
- Uložte upravenou prezentaci.
Tento Java kód ukazuje, jak vytvořit tabulku v prezentaci:
import com.aspose.slides.*;
import java.awt.Color;
// Vytvoří instanci třídy Presentation, která představuje soubor PPTX
Presentation pres = new Presentation();
try {
// Přistupuje k prvnímu snímku
ISlide sld = pres.getSlides().get_Item(0);
// Definuje sloupce s šířkami a řádky s výškami
double[] dblCols = {50, 50, 50};
double[] dblRows = {50, 30, 30, 30, 30};
// Přidá tvar tabulky na snímek
ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);
// Nastaví formát okraje pro každou buňku
for (int row = 0; row < tbl.getRows().size(); row++)
{
for (int cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++)
{
ICellFormat cellFormat = tbl.getRows().get_Item(row).get_Item(cell).getCellFormat();
cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
cellFormat.getBorderTop().setWidth(5);
cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
cellFormat.getBorderBottom().setWidth(5);
cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
cellFormat.getBorderLeft().setWidth(5);
cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
cellFormat.getBorderRight().setWidth(5);
}
}
// Spojí buňky 1 a 2 v řádku 1
tbl.mergeCells(tbl.getRows().get_Item(0).get_Item(0), tbl.getRows().get_Item(0).get_Item(1), false);
// Přidá text do sloučené buňky
tbl.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells");
// Uloží prezentaci na disk
pres.save("table.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Číslování ve standardní tabulce
Ve standardní tabulce je číslování buněk jednoduché a začíná nulou. První buňka v tabulce má index 0,0 (sloupec 0, řádek 0).
Například buňky v tabulce se 4 sloupci a 4 řádky jsou očíslovány takto:
| (0, 0) | (1, 0) | (2, 0) | (3, 0) |
|---|---|---|---|
| (0, 1) | (1, 1) | (2, 1) | (3, 1) |
| (0, 2) | (1, 2) | (2, 2) | (3, 2) |
| (0, 3) | (1, 3) | (2, 3) | (3, 3) |
Tento Java kód ukazuje, jak určit číslování buněk v tabulce:
import com.aspose.slides.*;
import java.awt.Color;
// Vytvoří instanci třídy Presentation, která představuje soubor PPTX
Presentation pres = new Presentation();
try {
// Přistupuje k prvnímu snímku
ISlide sld = pres.getSlides().get_Item(0);
// Definuje sloupce s šířkami a řádky s výškami
double[] dblCols = { 70, 70, 70, 70 };
double[] dblRows = { 70, 70, 70, 70 };
// Přidá tvar tabulky na snímek
ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);
// Nastaví formát okraje pro každou buňku
for (IRow row : tbl.getRows())
{
for (ICell cell : row)
{
cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.Solid);
cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
cell.getCellFormat().getBorderTop().setWidth(5);
cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.Solid);
cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
cell.getCellFormat().getBorderBottom().setWidth(5);
cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.Solid);
cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
cell.getCellFormat().getBorderLeft().setWidth(5);
cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.Solid);
cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
cell.getCellFormat().getBorderRight().setWidth(5);
}
}
// Uloží prezentaci na disk
pres.save("StandardTables_out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Přístup k existující tabulce
-
Vytvořte instanci třídy Presentation.
-
Získejte odkaz na snímek obsahující tabulku pomocí jeho indexu.
-
Vytvořte objekt ITable a nastavte jej na
null. -
Procházejte všechny objekty IShape až do nalezení tabulky.
Pokud máte podezření, že daný snímek obsahuje jedinou tabulku, můžete jednoduše zkontrolovat všechny tvary, které obsahuje. Když je tvar identifikován jako tabulka, můžete jej typově převést na objekt Table. Pokud však snímek obsahuje několik tabulek, je lepší najít požadovanou tabulku pomocí jejího setAlternativeText(String value).
-
Použijte objekt ITable k práci s tabulkou. V níže uvedeném příkladu nastavíme text buňky v tabulce.
-
Uložte upravenou prezentaci.
Tento Java kód ukazuje, jak přistupovat k existující tabulce a s ní pracovat:
import com.aspose.slides.*;
// Vytvoří instanci třídy Presentation, která představuje soubor PPTX
Presentation pres = new Presentation("UpdateExistingTable.pptx");
try {
// Přistupuje k prvnímu snímku
ISlide sld = pres.getSlides().get_Item(0);
// Inicializuje null TableEx
ITable tbl = null;
// Prochází tvary a nastaví odkaz na nalezenou tabulku
for (IShape shp : sld.getShapes())
{
if (shp instanceof ITable)
{
tbl = (ITable) shp;
// Nastaví text pro první sloupec druhého řádku
tbl.get_Item(0, 1).getTextFrame().setText("New");
}
}
// Uloží upravenou prezentaci na disk
pres.save("table1_out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Najít buňku, která vlastní textový rámec
Když obecný kód pro zpracování textu získá objekt ITextFrame z tabulky, použijte metodu ITextFrame.getParentCell k získání vlastníka – ICell. Pro textový rámec buňky tabulky metoda ITextFrame.getParentCell vrací vlastníka a metoda ITextFrame.getParentShape vrací null, i když je tabulka samotná tvarem.
Souřadnice buňky jsou dostupné pomocí jen pro čtení metod ICell.getFirstColumnIndex a ICell.getFirstRowIndex. Metoda ITextFrame.getParentCell také poskytuje jen‑pro‑čtení navigaci: vrací vlastníka, ale nezmění vlastnictví. Vždy před použitím zkontrolujte, zda vrácená buňka není null.
Kompletní příklad, který identifikuje vlastníky buňky tabulky a tvaru, včetně tvarů spojených se SmartArt uzly, najdete v Search and Replace Text.
Zarovnat text v tabulce
- Vytvořte instanci třídy Presentation.
- Získejte odkaz na snímek pomocí jeho indexu.
- Přidejte objekt ITable na snímek.
- Získejte objekt ITextFrame z tabulky.
- Přistupte k IParagraph v rámci ITextFrame.
- Zarovnejte text svisle.
- Uložte upravenou prezentaci.
Tento Java kód ukazuje, jak zarovnat text v tabulce:
import com.aspose.slides.*;
import java.awt.Color;
// Vytvoří instanci třídy Presentation
Presentation pres = new Presentation();
try {
// Získá první snímek
ISlide slide = pres.getSlides().get_Item(0);
// Definuje sloupce s šířkami a řádky s výškami
double[] dblCols = { 120, 120, 120, 120 };
double[] dblRows = { 100, 100, 100, 100 };
// Přidá tvar tabulky na snímek
ITable tbl = slide.getShapes().addTable(100, 50, dblCols, dblRows);
tbl.get_Item(1, 0).getTextFrame().setText("10");
tbl.get_Item(2, 0).getTextFrame().setText("20");
tbl.get_Item(3, 0).getTextFrame().setText("30");
// Přistupuje k textovému rámci
ITextFrame txtFrame = tbl.get_Item(0, 0).getTextFrame();
// Vytvoří objekt Paragraph pro textový rámec
IParagraph paragraph = txtFrame.getParagraphs().get_Item(0);
// Vytvoří objekt Portion pro odstavec
IPortion portion = paragraph.getPortions().get_Item(0);
portion.setText("Text here");
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
// Zarovná text svisle
ICell cell = tbl.get_Item(0, 0);
cell.setTextAnchorType(TextAnchorType.Center);
cell.setTextVerticalType(TextVerticalType.Vertical270);
// Uloží prezentaci na disk
pres.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Nastavit formátování textu na úrovni tabulky
- Vytvořte instanci třídy Presentation.
- Získejte odkaz na snímek pomocí jeho indexu.
- Získejte objekt ITable ze snímku.
- Nastavte setFontHeight(float value) pro text.
- Nastavte setAlignment(int value) a setMarginRight(float value).
- Nastavte setTextVerticalType(byte value).
- Uložte upravenou prezentaci.
Tento Java kód ukazuje, jak použít preferované možnosti formátování na text v tabulce:
import com.aspose.slides.*;
// Vytvoří instanci třídy Presentation
Presentation pres = new Presentation("simpletable.pptx");
try {
// Předpokládejme, že první tvar na prvním snímku je tabulka
ITable someTable = (ITable) pres.getSlides().get_Item(0).getShapes().get_Item(0);
// Nastaví výšku písma buněk tabulky
PortionFormat portionFormat = new PortionFormat();
portionFormat.setFontHeight(25);
someTable.setTextFormat(portionFormat);
// Nastaví zarovnání textu buněk tabulky a pravý okraj v jednom volání
ParagraphFormat paragraphFormat = new ParagraphFormat();
paragraphFormat.setAlignment(TextAlignment.Right);
paragraphFormat.setMarginRight(20);
someTable.setTextFormat(paragraphFormat);
// Nastaví vertikální typ textu buněk tabulky
TextFrameFormat textFrameFormat = new TextFrameFormat();
textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
someTable.setTextFormat(textFrameFormat);
pres.save("result.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Získat vlastnosti stylu tabulky
Aspose.Slides vám umožňuje načíst vlastnosti stylu tabulky, abyste je mohli použít pro jinou tabulku nebo kdekoliv jinde. Tento Java kód ukazuje, jak získat vlastnosti stylu z přednastaveného stylu tabulky:
import com.aspose.slides.*;
Presentation pres = new Presentation();
try {
ITable table = pres.getSlides().get_Item(0).getShapes().addTable(10, 10, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
table.setStylePreset(TableStylePreset.DarkStyle1); // změnit výchozí přednastavení stylu tématu
// Získat přednastavení stylu tabulky
int stylePreset = table.getStylePreset();
System.out.println("Table style preset: " + stylePreset);
// Použít získané přednastavení stylu na jinou tabulku
ITable anotherTable = pres.getSlides().get_Item(0).getShapes().addTable(10, 100, new double[] { 100, 150 }, new double[] { 5, 5, 5 });
anotherTable.setStylePreset(stylePreset);
pres.save("table.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Uzamknout poměr stran tabulky
Poměr stran geometrického tvaru je poměr jeho velikostí v různých rozměrech. Aspose.Slides poskytuje vlastnost setAspectRatioLocked pro uzamčení nastavení poměru stran u tabulek i dalších tvarů.
Tento Java kód ukazuje, jak uzamknout poměr stran pro tabulku:
import com.aspose.slides.*;
Presentation pres = new Presentation("pres.pptx");
try {
ITable table = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0);
System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());
table.getGraphicalObjectLock().setAspectRatioLocked(!table.getGraphicalObjectLock().getAspectRatioLocked()); // invertovat
System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());
pres.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
FAQ
Mohu povolit směr čtení zprava doleva (RTL) pro celou tabulku a text v jejích buňkách?
Ano. Tabulka nabízí metodu setRightToLeft, a odstavce mají ParagraphFormat.setRightToLeft. Použití obou zajišťuje správné RTL pořadí a vykreslení uvnitř buněk.
Jak mohu zabránit uživatelům v přesouvání nebo změně velikosti tabulky v konečném souboru?
Použijte zámky tvaru k zakázání přesouvání, změny velikosti, výběru atd. Tyto zámky platí i pro tabulky.
Je podporováno vkládání obrázku do buňky jako pozadí?
Ano. Pro buňku můžete nastavit picture fill; obrázek pokryje oblast buňky podle zvoleného režimu (roztažení nebo dlaždice).