使用 Python 管理簡報中的表格儲存格

本頁內容簡介

使用 Aspose.Slides for Python via Java，輕鬆在 PowerPoint 中管理表格儲存格。快速掌握存取、修改與樣式設定，實現順暢的投影片自動化。

概述

Aspose.Slides 讓您可以存取與修改 PowerPoint 簡報中的表格儲存格。本文說明如何識別合併的表格儲存格、移除儲存格邊框、在合併或分割儲存格後處理儲存格編號、變更儲存格的背景色，以及在表格儲存格內加入圖片。範例示範如何建立或開啟簡報、從投影片取得表格、透過儲存格屬性更新儲存格格式，並將修改後的簡報儲存為 PPTX 檔案。

識別合併的表格儲存格

1. 建立 Presentation 類別的實例。
2. 從第一張投影片取得表格。
3. 逐行逐列遍歷表格以找出合併的儲存格。
4. 發現合併儲存格時列印訊息。

以下 Python 程式碼示範如何在簡報中識別合併的表格儲存格：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Table

presentation = Presentation("SomePresentationWithTable.pptx")
try:
    # 假設第一張投影片上的第一個圖形是一個表格。
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
    if isinstance(shape, Table):
        table = shape
        for i in range(table.getRows().size()):
            for j in range(table.getColumns().size()):
                current_cell = table.getRows().get_Item(i).get_Item(j)
                if current_cell.isMergedCell():
                    print(f"Cell {i};{j} is part of a merged cell with RowSpan={current_cell.getRowSpan()} and ColSpan={current_cell.getColSpan()} starting from Cell {current_cell.getFirstRowIndex()};{current_cell.getFirstColumnIndex()}.")
    else:
        print("The first shape is not a table.")
finally:
    presentation.dispose()

移除表格儲存格邊框

1. 建立 Presentation 類別的實例。
2. 依索引取得投影片的參考。
3. 定義欄寬清單。
4. 定義列高清單。
5. 透過 addTable 方法將表格加入投影片。
6. 逐一儲存格清除上、下、左、右邊框。
7. 將修改後的簡報儲存為 PPTX 檔案。

以下 Python 程式碼示範如何移除表格儲存格的邊框：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat

presentation = Presentation()
try:
    # 存取第一張投影片。
    slide = presentation.getSlides().get_Item(0)

    # 定義欄寬與列高。
    column_widths = [50, 50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]

    # 將表格加入投影片。
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # 設定每個儲存格的邊框格式。
    for row in table.getRows():
        for cell in row:
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.NoFill)
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.NoFill)
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.NoFill)
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.NoFill)

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("table_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

合併儲存格中的編號

如果我們合併兩對儲存格 (1, 1) 與 (2, 1)、以及 (1, 2) 與 (2, 2)，結果表格仍保留其儲存格編號。以下 Python 程式碼示範此過程：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    # 存取第一張投影片。
    slide = presentation.getSlides().get_Item(0)

    # 定義欄寬與列高。
    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]

    # 將表格加入投影片。
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # 設定每個儲存格的邊框格式。
    for row in table.getRows():
        for cell in 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)


    # 合併儲存格 (1, 1) 與 (2, 1)。
    table.mergeCells(table.get_Item(1, 1), table.get_Item(2, 1), False)

    # 合併儲存格 (1, 2) 與 (2, 2)。
    table.mergeCells(table.get_Item(1, 2), table.get_Item(2, 2), False)

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("MergeCells_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

接著我們進一步合併儲存格，將 (1, 1) 與 (1, 2) 合併。結果是一個在中心擁有大型合併儲存格的表格：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    # 存取第一張投影片。
    slide = presentation.getSlides().get_Item(0)

    # 定義欄寬與列高。
    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]

    # 將表格加入投影片。
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # 設定每個儲存格的邊框格式。
    for row in table.getRows():
        for cell in 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)


    # 合併儲存格 (1, 1) 與 (2, 1)。
    table.mergeCells(table.get_Item(1, 1), table.get_Item(2, 1), False)

    # 合併儲存格 (1, 2) 與 (2, 2)。
    table.mergeCells(table.get_Item(1, 2), table.get_Item(2, 2), False)

    # 合併儲存格 (1, 1) 與 (1, 2)。
    table.mergeCells(table.get_Item(1, 1), table.get_Item(1, 2), True)

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("MergeCells_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

分割儲存格的編號

在前述範例中，合併表格儲存格不會改變其他儲存格的編號。

這次，我們使用一個普通表格（未合併儲存格）並嘗試分割儲存格 (1, 1) 以產生特殊表格。您可能需要留意此表格的編號，雖然看起來怪異，但這正是 Microsoft PowerPoint 對表格儲存格進行編號的方式，Aspose.Slides 亦如此。

以下 Python 程式碼示範我們所描述的過程：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    # 存取第一張投影片。
    slide = presentation.getSlides().get_Item(0)

    # 定義欄寬與列高。
    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]

    # 將表格加入投影片。
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # 設定每個儲存格的邊框格式。
    for row in table.getRows():
        for cell in 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)


    # 分割儲存格 (1, 1)。
    table.get_Item(1, 1).splitByWidth(table.get_Item(2, 1).getWidth() / 2)

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("SplitCells_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

變更表格儲存格的背景色

以下 Python 程式碼示範如何變更表格儲存格的背景色：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    # 存取第一張投影片。
    slide = presentation.getSlides().get_Item(0)

    # 定義欄寬與列高。
    column_widths = [150, 150, 150, 150]
    row_heights = [50, 50, 50, 50, 50]

    # 將表格加入投影片。
    table = slide.getShapes().addTable(50, 50, column_widths, row_heights)

    # 設定儲存格的背景顏色。
    cell = table.get_Item(2, 3)
    cell.getCellFormat().getFillFormat().setFillType(FillType.Solid)
    cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(Color.RED)

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("cell_background_color.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

在表格儲存格內加入圖片

1. 建立 Presentation 類別的實例。
2. 依索引取得投影片的參考。
3. 定義欄寬清單。
4. 定義列高清單。
5. 透過 addTable 方法將表格加入投影片。
6. 使用 Images.fromFile 載入圖片檔案。
7. 將圖片加入簡報以建立 PPImage 物件。
8. 將表格儲存格的 FillFormat 填充類型設定為 FillType.Picture。
9. 將圖片加入表格的第一個儲存格。
10. 將修改後的簡報儲存為 PPTX 檔案。

以下 Python 程式碼示範在建立表格時如何將圖片放入儲存格內：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Images, FillType, PictureFillMode, SaveFormat

presentation = Presentation()
try:
    # 存取第一張投影片。
    slide = presentation.getSlides().get_Item(0)

    # 定義欄寬與列高。
    column_widths = [150, 150, 150, 150]
    row_heights = [100, 100, 100, 100, 90]

    # 將表格加入投影片。
    table = slide.getShapes().addTable(50, 50, column_widths, row_heights)

    # 從圖片檔案建立簡報影像。
    image = Images.fromFile("image.jpg")
    try:
        picture = presentation.getImages().addImage(image)
    finally:
        image.dispose()

    # 將圖片加入第一個表格儲存格。
    cell_format = table.get_Item(0, 0).getCellFormat()
    cell_format.getFillFormat().setFillType(FillType.Picture)
    cell_format.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch)
    cell_format.getFillFormat().getPictureFillFormat().getPicture().setImage(picture)

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("Image_In_TableCell_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

常見問題

我可以為單一儲存格的不同邊設定不同的線條粗細與樣式嗎？

可以。top/bottom/left/right 邊框各自有獨立屬性，因而可以讓每一側的粗細與樣式不同。這與本文中示範的每側邊框控制邏輯一致。

在將圖片設為儲存格背景後，若變更欄或列的大小，圖片會發生什麼變化？

行為取決於 fill mode（stretch/​tile）。使用 stretch 時，圖片會隨新儲存格尺寸調整；使用 tile 時，圖磚會重新計算。本文提及了儲存格內圖片的顯示模式。

我可以為儲存格內的全部內容指定超連結嗎？

Hyperlinks 設定於儲存格文字框內的文字（段落）層級，或整個表格/形狀層級。實務上，您可以將連結指派給段落或儲存格內的全部文字。

我可以在單一儲存格內使用不同的字型嗎？

可以。儲存格的文字框支援 portions（文字跑）具有獨立的格式設定——包括字體、樣式、大小與顏色。