管理 Android 上的簡報圖形

概述

本文說明如何使用 Aspose.Slides 在簡報中操作圖形。內容包括如何在投影片上尋找圖形、複製、刪除、隱藏、變更順序、取得 Interop 圖形 ID，以及設定替代文字以供辨識與後續處理。

此外，還涵蓋如何存取圖形的版面配置格式、將圖形匯出為 SVG、在投影片上對齊圖形，以及使用翻轉屬性進行水平與垂直鏡像。最後，本文提供了關於圖形合併、堆疊順序與圖形鎖定的簡短 FAQ。

在投影片上尋找圖形

本主題將說明一種簡單技巧，讓開發人員在不使用內部 Id 的情況下，更容易在投影片上找到特定圖形。必須了解 PowerPoint 簡報檔案只能透過內部唯一 Id 來識別投影片上的圖形，直接使用此 Id 來尋找圖形對開發人員而言相當困難。所有加入投影片的圖形皆可設定替代文字（Alt Text）。建議開發人員利用替代文字來搜尋特定圖形。您可以使用 Microsoft PowerPoint 為未來可能變更的物件定義替代文字。

在為任意所需圖形設定替代文字後，您即可使用 Aspose.Slides for Android via Java 開啟該簡報，並遍歷投影片上所有圖形。於每次迭代時檢查圖形的替代文字，與之匹配的圖形即為您需要的圖形。為了更清楚說明此技巧，我們建立了一個方法findShape，可在投影片中找到特定圖形，並直接回傳該圖形。

// 實例化一個代表簡報檔案的 Presentation 類別
Presentation pres = new Presentation("FindingShapeInSlide.pptx");
try {

    ISlide slide = pres.getSlides().get_Item(0);
    // 要尋找的圖形的替代文字
    IShape shape = findShape(slide, "Shape1");
    if (shape != null)
    {
        System.out.println("Shape Name: " + shape.getName());
    }
} finally {
    if (pres != null) pres.dispose();
}

// 方法實作：使用替代文字在投影片中尋找圖形
public static IShape findShape(ISlide slide, String alttext)
{
    // 迭代投影片內的所有圖形
    for (int i = 0; i < slide.getShapes().size(); i++)
    {
        // 如果投影片的替代文字與所需的相符，則
        // 回傳該圖形
        if (slide.getShapes().get_Item(i).getAlternativeText().compareTo(alttext) == 0)
            return slide.getShapes().get_Item(i);
    }
    return null;
}

複製圖形

使用 Aspose.Slides for Android via Java 複製圖形至投影片的步驟：

1. 建立 Presentation 類別的實例。
2. 依索引取得投影片參考。
3. 取得來源投影片的圖形集合。
4. 向簡報中新加入投影片。
5. 從來源投影片的圖形集合複製圖形至新投影片。
6. 將修改後的簡報儲存為 PPTX 檔案。

以下範例在投影片中加入一個群組圖形。

// 實例化 Presentation 類別
Presentation pres = new Presentation("Source Frame.pptx");
try {
    IShapeCollection sourceShapes = pres.getSlides().get_Item(0).getShapes();
    ILayoutSlide blankLayout = pres.getMasters().get_Item(0).getLayoutSlides().getByType(SlideLayoutType.Blank);
    ISlide destSlide = pres.getSlides().addEmptySlide(blankLayout);
    IShapeCollection destShapes = destSlide.getShapes();
    destShapes.addClone(sourceShapes.get_Item(1), 50, 150 + sourceShapes.get_Item(0).getHeight());
    destShapes.addClone(sourceShapes.get_Item(2));
    destShapes.insertClone(0, sourceShapes.get_Item(0), 50, 150);

    // 將 PPTX 檔寫入磁碟
    pres.save("CloneShape_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

移除圖形

Aspose.Slides for Android via Java 允許開發人員移除任何圖形。若要從投影片中移除圖形，請依照以下步驟操作：

1. 建立 Presentation 類別的實例。
2. 取得第一張投影片。
3. 依特定 AlternativeText 找到圖形。
4. 移除該圖形。
5. 將檔案儲存至磁碟。

// 建立 Presentation 物件
Presentation pres = new Presentation();
try {
    // 取得第一張投影片
    ISlide sld = pres.getSlides().get_Item(0);

    // 新增矩形類型的自動圖形
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String altText = "User Defined";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(0);
        if (alttext.equals(ashp.getAlternativeText()))
        {
            sld.getShapes().remove(ashp);
        }
    }

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

隱藏圖形

Aspose.Slides for Android via Java 允許開發人員隱藏任何圖形。若要在投影片中隱藏圖形，請依照以下步驟操作：

1. 建立 Presentation 類別的實例。
2. 取得第一張投影片。
3. 依特定 AlternativeText 找到圖形。
4. 隱藏該圖形。
5. 將檔案儲存至磁碟。

// 實例化代表 PPTX 的 Presentation 類別
Presentation pres = new Presentation();
try {
    // 取得第一張投影片
    ISlide sld = pres.getSlides().get_Item(0);

    // 新增矩形類型的自動圖形
    sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);

    String alttext = "User Defined";
    int iCount = sld.getShapes().size();
    for (int i = 0; i < iCount; i++)
    {
        AutoShape ashp = (AutoShape)sld.getShapes().get_Item(i);
        if (alttext.equals(ashp.getAlternativeText()))
        {
            ashp.setHidden(true);
        }
    }

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

變更圖形順序

Aspose.Slides for Android via Java 允許開發人員重新排列圖形。重新排列圖形可指定哪個圖形位於前端或後端。若要在投影片中重新排列圖形，請依照以下步驟操作：

1. 建立 Presentation 類別的實例。
2. 取得第一張投影片。
3. 新增一個圖形。
4. 在圖形的文字框中加入文字。
5. 再新增另一個位置相同的圖形。
6. 重新排列圖形。
7. 將檔案儲存至磁碟。

Presentation pres = new Presentation("ChangeShapeOrder.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IAutoShape shp3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 365, 400, 150);
    shp3.getFillFormat().setFillType(FillType.NoFill);
    shp3.addTextFrame(" ");

    IParagraph para = shp3.getTextFrame().getParagraphs().get_Item(0);
    IPortion portion = para.getPortions().get_Item(0);
    portion.setText("Watermark Text Watermark Text Watermark Text");

    shp3 = slide.getShapes().addAutoShape(ShapeType.Triangle, 200, 365, 400, 150);

    slide.getShapes().reorder(2, shp3);

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

取得 Interop 圖形 ID

Aspose.Slides for Android via Java 允許開發人員取得投影片範圍內的唯一圖形識別碼，這與 getUniqueId 方法（取得簡報範圍內的唯一識別碼）不同。已在 IShape 介面與 Shape 類別中加入 getOfficeInteropShapeId 方法。此方法回傳的值對應於 Microsoft.Office.Interop.PowerPoint.Shape 物件的 Id。以下提供範例程式碼。

Presentation pres = new Presentation("Presentation.pptx");
try {
    // 取得投影片範圍內的唯一圖形識別碼
    long officeInteropShapeId = pres.getSlides().get_Item(0).getShapes().get_Item(0).getOfficeInteropShapeId();

} finally {
    if (pres != null) pres.dispose();
}

設定圖形的替代文字

Aspose.Slides for Android via Java 允許開發人員設定任意圖形的 AlternateText。簡報中的圖形可透過 AlternativeText 或 Shape Name 方法加以辨識。setAlternativeText 與 getAlternativeText 方法可同時在 Aspose.Slides 與 Microsoft PowerPoint 中讀寫。使用此方法，您能為圖形加標籤，並執行移除圖形、隱藏圖形或在投影片上重新排列圖形等操作。設定圖形的 AlternateText，請依照以下步驟操作：

1. 建立 Presentation 類別的實例。
2. 取得第一張投影片。
3. 向投影片新增任意圖形。
4. 對新加入的圖形進行必要的操作。
5. 遍歷圖形集合以尋找目標圖形。
6. 設定 AlternativeText。
7. 將檔案儲存至磁碟。

// 實例化代表 PPTX 的 Presentation 類別
Presentation pres = new Presentation();
try {
    // 取得第一張投影片
    ISlide sld = pres.getSlides().get_Item(0);

    // 新增矩形類型的自動圖形
    IShape shp1 = sld.getShapes().addAutoShape(ShapeType.Rectangle, 50, 40, 150, 50);
    IShape shp2 = sld.getShapes().addAutoShape(ShapeType.Moon, 160, 40, 150, 50);
    shp2.getFillFormat().setFillType(FillType.Solid);
    shp2.getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    for (int i = 0; i < sld.getShapes().size(); i++)
    {
        AutoShape shape = (AutoShape) sld.getShapes().get_Item(i);
        if (shape != null)
        {
            shape.setAlternativeText("User Defined");
        }
    }

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

存取圖形的版面格式

Aspose.Slides for Android via Java 提供簡易 API 以存取圖形的版面格式。本文示範如何取得版面格式。

以下提供範例程式碼。

Presentation pres = new Presentation("pres.pptx");
try {
    for (ILayoutSlide layoutSlide : pres.getLayoutSlides())
    {
        for (IShape shape : layoutSlide.getShapes())
        {
            IFillFormat fillFormats = shape.getFillFormat();
            ILineFormat lineFormats = shape.getLineFormat();
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

將圖形匯出為 SVG

現在 Aspose.Slides for Android via Java 支援將圖形匯出為 SVG。已在 Shape 類別與 IShape 介面中加入 writeAsSvg 方法（及其重載），可將圖形內容儲存為 SVG 檔案。以下程式碼示範如何將投影片的圖形匯出為 SVG 檔案。

Presentation pres = new Presentation("TestExportShapeToSvg.pptx");
try {
    FileOutputStream stream = new FileOutputStream("SingleShape.svg");
    try {
        pres.getSlides().get_Item(0).getShapes().get_Item(0).writeAsSvg(stream);
    } finally {
        if (stream != null) stream.close();
    }
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

對齊圖形

Aspose.Slides 允許將圖形相對於投影片邊界或相對於彼此對齊。為此目的，已新增重載方法 SlidesUtil.alignShape()。ShapesAlignmentType 列舉定義了可能的對齊選項。

範例 1

以下原始碼將索引為 1、2 與 4 的圖形對齊至投影片上緣。

Presentation pres = new Presentation("example.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IShape shape1 = slide.getShapes().get_Item(1);
    IShape shape2 = slide.getShapes().get_Item(2);
    IShape shape3 = slide.getShapes().get_Item(4);
    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, true, pres.getSlides().get_Item(0), new int[]
    {
        slide.getShapes().indexOf(shape1),
        slide.getShapes().indexOf(shape2),
        slide.getShapes().indexOf(shape3)
    });
} finally {
    if (pres != null) pres.dispose();
}
}

範例 2

以下範例示範如何將整個圖形集合相對於集合中最底部的圖形進行對齊。

Presentation pres = new Presentation("example.pptx");
try {
    SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0));
} finally {
    if (pres != null) pres.dispose();
}

翻轉屬性

在 Aspose.Slides 中，ShapeFrame 類別提供 flipH 與 flipV 屬性，以控制圖形的水平與垂直鏡像。兩個屬性的類型皆為 byte，1 表示翻轉，0 表示不翻轉，-1 表示使用預設行為。這些值可從圖形的 Frame 取得。

若要修改翻轉設定，可使用圖形目前的位置與大小、目標 flipH、flipV 以及旋轉角度建立新的 ShapeFrame 實例。將此實例指派給圖形的 Frame 後儲存簡報，即會套用鏡像變換並寫入輸出檔案。

假設我們有一個 sample.pptx 檔案，第一張投影片僅包含一個使用預設翻轉設定的圖形，如下所示。

以下程式碼範例取得圖形目前的翻轉屬性，並同時水平與垂直翻轉該圖形。

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);

    // 取得圖形的水平翻轉屬性。
    byte horizontalFlip = shape.getFrame().getFlipH();
    System.out.println("Horizontal flip: " + horizontalFlip);

    // 取得圖形的垂直翻轉屬性。
    byte verticalFlip = shape.getFrame().getFlipV();
    System.out.println("Vertical flip: " + verticalFlip);

    float x = shape.getFrame().getX();
    float y = shape.getFrame().getY();
    float width = shape.getFrame().getWidth();
    float height = shape.getFrame().getHeight();
    byte flipH = NullableBool.True; // Flip horizontally.
    byte flipV = NullableBool.True; // Flip horizontally.
    float rotation = shape.getFrame().getRotation();

    shape.setFrame(new ShapeFrame(x, y, width, height, flipH, flipV, rotation));

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

結果：

常見問題

我可以在投影片上像桌面編輯器一樣合併圖形（聯集/交集/相減）嗎？

目前未提供內建的布林運算 API。您可以自行建構所需的輪廓，例如使用 GeometryPath 計算結果幾何，然後依該輪廓建立新圖形，必要時移除原始圖形。

我要如何控制堆疊順序（z‑order），讓圖形始終保持在最上層？

調整投影片的 shapes 集合中的插入或移動順序。為獲得可預測的結果，請在完成所有其他投影片修改後最後確定 z‑order。

我可以「鎖定」圖形，使 PowerPoint 使用者無法編輯它嗎？

可以。設定圖形層級的保護旗標（例如鎖定選取、移動、調整大小、文字編輯）。如有需要，也可在母片或版面上套用相同限制。請注意這僅是 UI 層級的保護，非安全機制；若需更強的保護，可結合檔案層級的限制，例如唯讀建議或密碼保護。