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

簡介

為了讓您能在 PowerPoint 簡報中管理表格的列與欄，Aspose.Slides 提供了 Table 類別、ITable 介面，以及許多其他類型。

將第一列設為標題

  1. 建立 Presentation 類別的實例並載入簡報。
  2. 透過索引取得投影片的參考。
  3. 建立一個 ITable 物件，並將其設定為 null。
  4. 遍歷所有 IShape 物件以尋找相關的表格。
  5. 將表格的第一列設定為標題列。

以下 Java 程式碼示範如何將表格的第一列設為標題列：

// 實例化 Presentation 類別
Presentation pres = new Presentation("table.pptx");
try {
    // 存取第一張投影片
    ISlide sld = pres.getSlides().get_Item(0);

    // 初始化 null TableEx
    ITable tbl = null;

    // 遍歷形狀並設定對表格的參考
    for (IShape shp : sld.getShapes())
    {
        if (shp instanceof ITable) 
        {
            tbl = (ITable)shp;
            
            //將表格的第一列設為標題列
            tbl.setFirstRow(true);
        }
    }
    
    // 將簡報儲存至磁碟
    pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

複製表格的列或欄

  1. 建立 Presentation 類別的實例並載入簡報，
  2. 透過索引取得投影片的參考。
  3. 定義一個 columnWidth 陣列。
  4. 定義一個 rowHeight 陣列。
  5. 透過 addTable 方法將 ITable 物件加入投影片。
  6. 複製表格列。
  7. 複製表格欄。
  8. 儲存已修改的簡報。

以下 Java 程式碼示範如何複製 PowerPoint 表格的列或欄：

 // 實例化 Presentation 類別
Presentation pres = new Presentation("Test.pptx");
try {
    // 存取第一張投影片
    ISlide sld = pres.getSlides().get_Item(0);

    // 定義欄寬與列高
    double[] dblCols = { 50, 50, 50 };
    double[] dblRows = { 50, 30, 30, 30, 30 };

    // 在投影片中新增表格形狀
    ITable table = sld.getShapes().addTable(100, 50, dblCols, dblRows);

    // 為第 1 列第 1 格加入文字
    table.get_Item(0, 0).getTextFrame().setText("Row 1 Cell 1");

    // 為第 1 列第 2 格加入文字
    table.get_Item(1, 0).getTextFrame().setText("Row 1 Cell 2");

    // 在表格末端複製第 1 列
    table.getRows().addClone(table.getRows().get_Item(0), false);

    // 為第 2 列第 1 格加入文字
    table.get_Item(0, 1).getTextFrame().setText("Row 2 Cell 1");

    // 為第 2 列第 2 格加入文字
    table.get_Item(1, 1).getTextFrame().setText("Row 2 Cell 2");

    // 複製第 2 列為表格的第 4 列
    table.getRows().insertClone(3, table.getRows().get_Item(1), false);

    // 在末端複製第一欄
    table.getColumns().addClone(table.getColumns().get_Item(0), false);

    // 在第 4 欄索引處複製第 2 欄
    table.getColumns().insertClone(3,table.getColumns().get_Item(1), false);
    
    // 將簡報儲存至磁碟
    pres.save("table_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

從表格中移除列或欄

  1. 建立 Presentation 類別的實例並載入簡報，
  2. 透過索引取得投影片的參考。
  3. 定義一個 columnWidth 陣列。
  4. 定義一個 rowHeight 陣列。
  5. 透過 addTable 方法將 ITable 物件加入投影片。
  6. 移除表格列。
  7. 移除表格欄。
  8. 儲存已修改的簡報。

以下 Java 程式碼示範如何從表格中移除列或欄：

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    
    double[] colWidth = { 100, 50, 30 };
    double[] rowHeight = { 30, 50, 30 };

    ITable table = slide.getShapes().addTable(100, 100, colWidth, rowHeight);
    table.getRows().removeAt(1, false);
    table.getColumns().removeAt(1, false);
    
    pres.save("TestTable_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

在表格列層級設定文字格式

  1. 建立 Presentation 類別的實例並載入簡報，
  2. 透過索引取得投影片的參考。
  3. 從投影片存取相關的 ITable 物件。
  4. 設定第一列儲存格的 setFontHeight(float value)。
  5. 設定第一列儲存格的 setAlignment(int value) 以及 setMarginRight(float value)。
  6. 設定第二列儲存格的 setTextVerticalType(byte value)。
  7. 儲存已修改的簡報。

以下 Java 程式碼演示此操作。

// 建立 Presentation 類別的實例
Presentation pres = new Presentation();
try {
    // 假設第一張投影片上的第一個形狀是表格
    ITable someTable = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0); 
    
    // 設定第一列儲存格的字型高度
    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
	
    someTable.getRows().get_Item(0).setTextFormat(portionFormat);
    
    // 設定第一列儲存格的文字對齊方式和右邊距
    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
	
    someTable.getRows().get_Item(0).setTextFormat(paragraphFormat);
    
    // 設定第二列儲存格的文字垂直類型
    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
	
    someTable.getRows().get_Item(1).setTextFormat(textFrameFormat);

  // 將簡報儲存至磁碟
    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

在表格欄層級設定文字格式

  1. 建立 Presentation 類別的實例並載入簡報，
  2. 透過索引取得投影片的參考。
  3. 從投影片存取相關的 ITable 物件。
  4. 設定第一欄儲存格的 setFontHeight(float value)。
  5. 設定第一欄儲存格的 setAlignment(int value) 以及 setMarginRight(float value)。
  6. 設定第二欄儲存格的 setTextVerticalType(byte value)。
  7. 儲存已修改的簡報。

以下 Java 程式碼演示此操作：

// 建立 Presentation 類別的實例
Presentation pres = new Presentation();
try {
    // 假設第一張投影片上的第一個形狀是表格
    ITable someTable = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0)];

    // 設定第一欄儲存格的字型高度
    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
	
    someTable.getColumns().get_Item(0).setTextFormat(portionFormat);

    // 在一次呼叫中設定第一欄儲存格的文字對齊方式和右邊距
    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
	
    someTable.getColumns().get_Item(0).setTextFormat(paragraphFormat);

    // 設定第二欄儲存格的文字垂直類型
    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
	
    someTable.getColumns().get_Item(1).setTextFormat(textFrameFormat);

    pres.save("result.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

取得表格樣式屬性

Aspose.Slides 允許您取得表格的樣式屬性，以便在其他表格或其他地方使用這些詳細資訊。以下 Java 程式碼示範如何從表格預設樣式取得樣式屬性：

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); // 更改預設樣式預置主題
    pres.save("table.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

常見問答

Can I apply PowerPoint themes/styles to a table that’s already created?
是的。表格會繼承投影片/版面配置/母片的佈景主題，且您仍可在該佈景主題之上覆寫填色、邊框與文字顏色。

Can I sort table rows like in Excel?
不行，Aspose.Slides 表格沒有內建排序或篩選功能。請先在記憶體中對資料進行排序，然後依該順序重新填入表格列。

Can I have banded (striped) columns while keeping custom colors on specific cells?
可以。開啟條紋欄後，對特定儲存格套用局部格式即會覆寫；儲存格層級的格式會優先於表格樣式。

在 Java 中管理簡報表格 使用 Java 在簡報中管理表格儲存格