在 Java 中管理簡報表格

本頁內容簡介

使用 Aspose.Slides for Java 在 PowerPoint 投影片中建立與編輯表格。探索簡單的程式碼範例，以簡化您的表格工作流程。

簡介

PowerPoint 中的表格將資訊組織成列與欄，讓閱讀與比較數值變得更容易。

Aspose.Slides 提供 Table 類別、ITable 介面、Cell 類別、ICell 介面以及其他類型，以便您在簡報中建立、更新和管理表格。

從頭建立表格

透過指定位置、欄寬與列高來建立表格。將其加入投影片後，您可以設定儲存格邊框、合併儲存格以及插入文字。

建立 Presentation 類別的實例。
依索引取得投影片的參照。
以點數定義欄寬陣列。
以點數定義列高陣列。
透過 addTable 方法將 ITable 物件加入投影片。
遍歷每個 ICell 以設定上、下、右、左邊框的格式。
合併表格第一列的前兩個儲存格。
透過其 getTextFrame 方法存取合併後的儲存格。
設定合併儲存格中的文字。
儲存已修改的簡報。

以下範例在 (100, 50) 點的位置建立一個包含三欄五列的表格。它套用寬度為 5 點的紅色邊框、合併第一列的前兩個儲存格，並將結果儲存為 table.pptx。

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 50, 50, 50 };
    double[] rowHeights = { 50, 30, 30, 30, 30 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (IRow row : table.getRows())
    {
        for (ICell cell : row)
        {
            ICellFormat cellFormat = 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);
        }
    }

    table.mergeCells(table.get_Item(0, 0), table.get_Item(1, 0), false);
    table.get_Item(0, 0).getTextFrame().setText("Merged Cells");

    presentation.save("table.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

標準表格的編號方式

在標準表格中，儲存格索引採用零基且以（欄, 列）的順序表示。第一個儲存格的索引為 (0, 0)。

例如，具有 4 欄 4 列的表格，其儲存格編號方式如下：

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

此範例建立上述示意的 4 × 4 表格，欄寬與列高皆為 70 點，且套用寬度為 5 點的紅色儲存格邊框。座標說明儲存格索引；範例保持儲存格為空，並將表格儲存為 StandardTables_out.pptx。

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 70, 70, 70, 70 };
    double[] rowHeights = { 70, 70, 70, 70 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (IRow row : table.getRows())
    {
        for (ICell cell : row)
        {
            ICellFormat cellFormat = 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);
        }
    }

    presentation.save("StandardTables_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

存取現有表格

表格儲存在投影片的形狀集合中。遍歷形狀以定位表格，然後使用 ITable 介面讀取或更新其儲存格。

使用 Presentation 類別載入簡報。
依索引取得包含該表格的投影片參照。
遍歷 IShape 物件，遇到表格時即停止。若投影片包含多個表格，請使用 getAlternativeText 來辨識所需的表格。
更新目標儲存格中的文字。
儲存已修改的簡報。

以下範例開啟 UpdateExistingTable.pptx，並在第一張投影片上找到第一個表格。它將第 0 欄第 1 列的儲存格設定為 New，並將結果儲存為 table1_out.pptx。輸入檔必須至少包含一張投影片，且該投影片上的第一個表格至少有一欄兩列。

import com.aspose.slides.*;

Presentation presentation = new Presentation("UpdateExistingTable.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof ITable) {
            table = (ITable) shape;
            break;
        }
    }

    if (table != null) {
        table.get_Item(0, 1).getTextFrame().setText("New");
        presentation.save("table1_out.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

若要調整現有表格的列高度並了解實際高度為何會超過請求的最小值，請參閱控制列高度。

找出擁有文字框的儲存格

當通用文字處理程式碼從表格取得 ITextFrame 時，請使用 ITextFrame.getParentCell 方法取得擁有者 ICell。對於表格儲存格的文字框，ITextFrame.getParentCell 會回傳擁有者，而 ITextFrame.getParentShape 會回傳 null，即使表格本身是一個形狀。

儲存格座標可透過唯讀的 ICell.getFirstColumnIndex 與 ICell.getFirstRowIndex 方法取得。ITextFrame.getParentCell 亦提供唯讀的導覽：它回傳擁有者但不會改變所有權。使用前務必檢查回傳的儲存格是否為 null。

若要取得完整範例以辨識表格儲存格與形狀的擁有者（包括與 SmartArt 節點相關的形狀），請參閱搜尋與取代文字。

對齊表格文字

您可以控制單一表格儲存格的垂直錨點與文字方向。本節範例將第一個儲存格的文字置中，並旋轉 270 度。

建立 Presentation 類別的實例。
依索引取得投影片的參照。
將 ITable 物件加入投影片。
從表格取得 ITextFrame 物件。
取得第一個 IParagraph 並設定其文字與顏色。
使用 setTextAnchorType 與 setTextVerticalType 設定儲存格的垂直錨點與文字方向。
儲存已修改的簡報。

此範例建立一個 4 × 4 表格，欄寬為 120 點、列高為 100 點。它格式化儲存格 (0, 0) 的文字，並在第一列的其他儲存格加入數值，最後將結果儲存為 Vertical_Align_Text_out.pptx。

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 120, 120, 120, 120 };
    double[] rowHeights = { 100, 100, 100, 100 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(1, 0).getTextFrame().setText("10");
    table.get_Item(2, 0).getTextFrame().setText("20");
    table.get_Item(3, 0).getTextFrame().setText("30");

    ITextFrame textFrame = table.get_Item(0, 0).getTextFrame();
    IParagraph paragraph = textFrame.getParagraphs().get_Item(0);

    IPortion portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);

    ICell cell = table.get_Item(0, 0);
    cell.setTextAnchorType(TextAnchorType.Center);
    cell.setTextVerticalType(TextVerticalType.Vertical270);

    presentation.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在表格層級設定文字格式

使用 setTextFormat 來對表格的所有儲存格套用文字格式。其多載接受部分、段落與文字框的格式設定，因而能在不遍歷各儲存格的情況下設定這些屬性。

使用 Presentation 類別載入簡報。
依索引取得投影片的參照。
從投影片取得 ITable 物件。
使用 setFontHeight 為文字設定字型大小。
使用 setAlignment 與 setMarginRight 設定段落對齊方式與右邊距。
使用 setTextVerticalType 設定文字方向。
儲存已修改的簡報。

以下範例開啟 table.pptx（該檔案必須至少包含一張投影片，且第一個形狀為表格）。它將字型大小設定為 25 點，段落右對齊且右邊距為 20 點，並將文字設定為垂直。格式化後的簡報儲存為 result.pptx。

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = (ITable) slide.getShapes().get_Item(0);

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.setTextFormat(textFrameFormat);

    presentation.save("result.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

取得表格樣式屬性

使用 getStylePreset 讀取表格的預設樣式，並使用 setStylePreset 指定樣式。本範例將 TableStylePreset.DarkStyle1 套用於一個表格，列印其預設值，並將相同的預設套用於第二個表格。兩個表格皆儲存於 table-style.pptx 中。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 100, 150 };
    double[] rowHeights = { 5, 5, 5 };
    ITable table = slide.getShapes().addTable(10, 10, columnWidths, rowHeights);
    table.setStylePreset(TableStylePreset.DarkStyle1);

    int stylePreset = table.getStylePreset();
    System.out.println("Table style preset: " + stylePreset);

    ITable anotherTable = slide.getShapes().addTable(10, 100, columnWidths, rowHeights);
    anotherTable.setStylePreset(stylePreset);

    presentation.save("table-style.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

鎖定表格的長寬比

表格的長寬比是寬度與高度的比例。使用 setAspectRatioLocked 可為表格鎖定此比例。

以下範例開啟 pres.pptx（該檔案必須至少包含一張投影片，且第一個形狀為表格）。它列印目前的鎖定狀態，啟用長寬比鎖定，列印更新後的狀態 (true)，並將結果儲存為 pres-out.pptx。

import com.aspose.slides.*;

Presentation presentation = new Presentation("pres.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable) slide.getShapes().get_Item(0);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(true);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    presentation.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

常見問題

我可以為整個表格及其儲存格內的文字啟用從右至左 (RTL) 閱讀方向嗎？

可以。表格提供 setRightToLeft 方法，段落則具有 ParagraphFormat.setRightToLeft。兩者皆使用即可確保儲存格內文字的正確 RTL 順序與呈現。

如何防止使用者在最終檔案中移動或調整表格大小？

使用形狀鎖定以停用移動、調整大小、選取等功能。這些鎖定同樣套用於表格。

是否支援在儲存格內插入圖片作為背景？

可以。您可以為儲存格設定 picture fill；圖片會依所選模式（拉伸或並排）覆蓋整個儲存格區域。

使用 Java 管理 PowerPoint 表格中的列與欄