管理 Java 中的簡報圖形

概述

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

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

在投影片上尋找圖形

本節將說明一種簡單技巧，讓開發者在不使用內部 Id 的情況下，更容易於投影片上找到特定圖形。需要注意的是，PowerPoint 檔案只能以內部唯一 Id 來辨識圖形，直接使用該 Id 會較為困難。所有加入投影片的圖形皆可設定替代文字 (Alt Text)。建議開發者利用替代文字來尋找特定圖形。您可以在 Microsoft PowerPoint 中為未來可能變更的物件設定替代文字。

設定完欲尋找圖形的替代文字後，即可使用 Aspose.Slides for 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 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 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 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 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 Java 允許開發者取得投影片範圍內唯一的圖形識別碼，這與 getUniqueId 方法（取得整份投影片檔案範圍內的唯一識別碼）不同。方法 getOfficeInteropShapeId 已加入至 IShape 介面與 Shape 類別。此方法回傳的值對應 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 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 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 Java 支援將圖形匯出為 SVG。方法 writeAsSvg（以及其重載）已加入至 Shape 類別與 IShape 介面。此方法可將圖形內容另存為 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; // 水平翻轉。
    byte flipV = NullableBool.True; // 水平翻轉。
    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 中編輯它嗎？

可以。設定 shape-level protection flags（例如鎖定選取、移動、調整大小、文字編輯）。必要時，也可在母片或版面上套用相同限制。請注意，這僅是 UI 層面的保護，非安全機制；若需更強的保護，請搭配檔案層面的限制，例如 唯讀建議或密碼。