在 Java 中管理 PowerPoint 文字段落

簡介

Aspose.Slides 提供您在 Java 中處理 PowerPoint 文字、段落與 Portion 所需的所有介面與類別。

Aspose.Slides 提供 ITextFrame 介面，讓您可以新增代表段落的物件。ITextFame 物件可以包含一個或多個段落（每個段落透過換行字元建立）。
Aspose.Slides 提供 IParagraph 介面，讓您可以新增代表 Portion 的物件。IParagraph 物件可以包含一個或多個 Portion（iPortions 物件的集合）。
Aspose.Slides 提供 IPortion 介面，讓您可以新增代表文字及其格式屬性的物件。

IParagraph 物件透過其底層的 IPortion 物件，能夠處理具有不同格式屬性的文字。

新增多段落且每段包含多個 Portion

以下步驟示範如何新增包含 3 個段落且每個段落包含 3 個 Portion 的文字框：

建立 Presentation 類別的實例。
依索引取得目標投影片的參考。
在投影片上加入矩形 IAutoShape。
取得與該 IAutoShape 相關聯的 ITextFrame。
建立兩個 IParagraph 物件，並將它們加入 ITextFrame 的 IParagraphs 集合。
為每個新 IParagraph 建立三個 IPortion 物件（預設段落建立兩個 Portion），並將每個 IPortion 加入對應 IParagraph 的 IPortion 集合。
為每個 Portion 設定文字內容。
使用 IPortion 物件所提供的格式屬性，為每個 Portion 套用所需的格式設定。
儲存已修改的簡報。

以下 Java 程式碼示範上述步驟的實作：

// 建立代表 PPTX 檔案的 Presentation 類別實例
Presentation pres = new Presentation();
try {
    // 存取第一張投影片
    ISlide slide = pres.getSlides().get_Item(0);

    // 新增矩形類型的 AutoShape
    IAutoShape ashp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);

    // 取得 AutoShape 的 TextFrame
    ITextFrame tf = ashp.getTextFrame();

    // 建立具有不同文字格式的段落與 Portion
    IParagraph para0 = tf.getParagraphs().get_Item(0);
    IPortion port01 = new Portion();
    IPortion port02 = new Portion();
    para0.getPortions().add(port01);
    para0.getPortions().add(port02);

    IParagraph para1 = new Paragraph();
    tf.getParagraphs().add(para1);
    IPortion port10 = new Portion();
    IPortion port11 = new Portion();
    IPortion port12 = new Portion();
    para1.getPortions().add(port10);
    para1.getPortions().add(port11);
    para1.getPortions().add(port12);

    IParagraph para2 = new Paragraph();
    tf.getParagraphs().add(para2);
    IPortion port20 = new Portion();
    IPortion port21 = new Portion();
    IPortion port22 = new Portion();
    para2.getPortions().add(port20);
    para2.getPortions().add(port21);
    para2.getPortions().add(port22);

    for (int i = 0; i < 3; i++) 
    {
        for (int j = 0; j < 3; j++) 
        {
            IPortion portion = tf.getParagraphs().get_Item(i).getPortions().get_Item(j); 
            portion.setText("Portion0" + j);
            if (j == 0) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);
                portion.getPortionFormat().setFontBold(NullableBool.True);
                portion.getPortionFormat().setFontHeight(15);
            } else if (j == 1) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
                portion.getPortionFormat().setFontItalic(NullableBool.True);
                portion.getPortionFormat().setFontHeight(18);
            }
        }
    }

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

管理段落項目符號

項目符號清單可協助您快速且有效率地組織與呈現資訊。使用項目符號的段落更易閱讀與理解。

建立 Presentation 類別的實例。
依索引取得目標投影片的參考。
在選取的投影片上加入自動圖形。
取得該自動圖形的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例。
將段落的項目符號 Type 設為 Symbol，並設定項目符號字元。
設定段落的 Text。
設定段落的項目符號 Indent。
為項目符號設定顏色。
設定項目符號的高度。
將新段落加入 TextFrame 的段落集合。
加入第二個段落，並重複第 7 至第 13 步的流程。
儲存簡報。

以下 Java 程式碼示範如何新增段落項目符號：

// 建立代表 PPTX 檔案的 Presentation 類別實例
Presentation pres = new Presentation();
try {
    // 存取第一張投影片
    ISlide slide = pres.getSlides().get_Item(0);
    
    // 新增並存取自動圖形
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // 取得自動圖形的文字框
    ITextFrame txtFrm = aShp.getTextFrame();

    // 移除預設段落
    txtFrm.getParagraphs().removeAt(0);

    // 建立段落
    Paragraph para = new Paragraph();

    // 設定段落的項目符號樣式與符號
    para.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar((char)8226);

    // 設定段落文字
    para.setText("Welcome to Aspose.Slides");

    // 設定項目符號縮排
    para.getParagraphFormat().setIndent(25);

    // 設定項目符號顏色
    para.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    para.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); // 設定 IsBulletHardColor 為 true 以使用自訂項目符號顏色

    // 設定項目符號高度
    para.getParagraphFormat().getBullet().setHeight(100);

    // 將段落加入文字框
    txtFrm.getParagraphs().add(para);

    // 建立第二個段落
    Paragraph para2 = new Paragraph();

    // 設定段落的項目符號類型與樣式
    para2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    para2.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain);

    // 加入段落文字
    para2.setText("This is numbered bullet");

    // 設定項目符號縮排
    para2.getParagraphFormat().setIndent(25);

    para2.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para2.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    para2.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); // 設定 IsBulletHardColor 為 true 以使用自訂項目符號顏色

    // 設定項目符號高度
    para2.getParagraphFormat().getBullet().setHeight(100);

    // 將段落加入文字框
    txtFrm.getParagraphs().add(para2);
    
    // 儲存已修改的簡報
    pres.save("Bullet_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

管理圖片項目符號

圖片項目符號可協助您快速且有效率地組織與呈現資訊。使用圖片段落更易閱讀與理解。

建立 Presentation 類別的實例。
依索引取得目標投影片的參考。
在投影片上加入自動圖形。
取得該自動圖形的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例。
透過 IPPImage 載入圖片。
將項目符號類型設定為 Picture，並指定圖片。
設定段落的 Text。
設定段落的項目符號 Indent。
為項目符號設定顏色。
設定項目符號的高度。
將新段落加入 TextFrame 的段落集合。
加入第二個段落，並依前述步驟重複操作。
儲存已修改的簡報。

以下 Java 程式碼示範如何新增與管理圖片項目符號：

// 建立代表 PPTX 檔案的 Presentation 類別實例
Presentation presentation = new Presentation();
try {
    // 存取第一張投影片
    ISlide slide = presentation.getSlides().get_Item(0);

    // 建立項目符號用的影像
    IPPImage picture;
    IImage image = Images.fromFile("bullets.png");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
    // 新增並存取自動圖形
    IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // 存取自動圖形的文字框
    ITextFrame textFrame = autoShape.getTextFrame();

    // 移除預設段落
    textFrame.getParagraphs().removeAt(0);

    // 建立新的段落
    Paragraph paragraph = new Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");

    // 設定段落的項目符號樣式與圖片
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(picture);

    // 設定項目符號高度
    paragraph.getParagraphFormat().getBullet().setHeight(100);

    // 將段落加入文字框
    textFrame.getParagraphs().add(paragraph);

    // 將簡報寫入 PPTX 檔案
    presentation.save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat.Pptx);

    // 將簡報寫入 PPT 檔案
    presentation.save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat.Ppt);
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

管理多層次項目符號

多層次項目符號可協助您快速且有效率地組織與呈現資訊。多層次項目符號易於閱讀與理解。

建立 Presentation 類別的實例。
依索引取得目標投影片的參考。
在新投影片上加入自動圖形。
取得該自動圖形的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例，並將深度設定為 0。
使用 Paragraph 類別建立第二個段落實例，將深度設定為 1。
使用 Paragraph 類別建立第三個段落實例，將深度設定為 2。
使用 Paragraph 類別建立第四個段落實例，將深度設定為 3。
將新段落加入 TextFrame 的段落集合。
儲存已修改的簡報。

以下 Java 程式碼示範如何新增與管理多層次項目符號：

// 建立代表 PPTX 檔案的 Presentation 類別實例
Presentation pres = new Presentation();
try {
    // 存取第一張投影片
    ISlide slide = pres.getSlides().get_Item(0);

    // 新增並存取自動圖形
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // 取得建立的自動圖形的文字框
    ITextFrame text = aShp.addTextFrame("");

    // 清除預設段落
    text.getParagraphs().clear();

    // 新增第一個段落
    IParagraph para1 = new Paragraph();
    para1.setText("Content");
    para1.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para1.getParagraphFormat().getBullet().setChar((char)8226);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // 設定項目符號層級
    para1.getParagraphFormat().setDepth((short)0);

    // 新增第二個段落
    IParagraph para2 = new Paragraph();
    para2.setText("Second Level");
    para2.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para2.getParagraphFormat().getBullet().setChar('-');
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // 設定項目符號層級
    para2.getParagraphFormat().setDepth((short)1);

    // 新增第三個段落
    IParagraph para3 = new Paragraph();
    para3.setText("Third Level");
    para3.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para3.getParagraphFormat().getBullet().setChar((char)8226);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // 設定項目符號層級
    para3.getParagraphFormat().setDepth((short)2);

    // 新增第四個段落
    IParagraph para4 = new Paragraph();
    para4.setText("Fourth Level");
    para4.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para4.getParagraphFormat().getBullet().setChar('-');
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // 設定項目符號層級
    para4.getParagraphFormat().setDepth((short)3);

    // 將段落加入集合
    text.getParagraphs().add(para1);
    text.getParagraphs().add(para2);
    text.getParagraphs().add(para3);
    text.getParagraphs().add(para4);

    // 將簡報寫入 PPTX 檔案
    pres.save("MultilevelBullet.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

管理自訂編號清單的段落

IBulletFormat 介面提供 NumberedBulletStartWith 屬性等，可讓您管理具有自訂編號或格式的段落。

建立 Presentation 類別的實例。
取得包含目標段落的投影片。
在投影片上加入自動圖形。
取得該自動圖形的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例，並將 NumberedBulletStartWith 設為 2。
使用 Paragraph 類別建立第二個段落實例，將 NumberedBulletStartWith 設為 3。
使用 Paragraph 類別建立第三個段落實例，將 NumberedBulletStartWith 設為 7。
將新段落加入 TextFrame 的段落集合。
儲存已修改的簡報。

以下 Java 程式碼示範如何新增與管理自訂編號或格式的段落：

Presentation presentation = new Presentation();
try {
    IAutoShape shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // 取得建立的自動圖形的文字框
    ITextFrame textFrame = shape.getTextFrame();

    // 移除預設的現有段落
    textFrame.getParagraphs().removeAt(0);

    // 第一個清單
    Paragraph paragraph1 = new Paragraph();
    paragraph1.setText("bullet 2");
    paragraph1.getParagraphFormat().setDepth((short)4);
    paragraph1.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)2);
    paragraph1.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph1);

    Paragraph paragraph2 = new Paragraph();
    paragraph2.setText("bullet 3");
    paragraph2.getParagraphFormat().setDepth((short)4);
    paragraph2.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)3);
    paragraph2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph2);


    Paragraph paragraph5 = new Paragraph();
    paragraph5.setText("bullet 7");
    paragraph5.getParagraphFormat().setDepth((short)4);
    paragraph5.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)7);
    paragraph5.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph5);

    presentation.save("SetCustomBulletsNumber-slides.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

為段落設定首行縮排

使用 IParagraphFormat.setIndent 方法可控制段落的首行縮排。此方法僅移動段落左邊界相對的第一行。正值會將第一行向右移動，而其餘行仍保持與段落正文對齊。

若需移動整個段落，請使用 IParagraphFormat.setMarginLeft。若只需移動第一行，則使用 IParagraphFormat.setIndent。

以下範例建立多個段落，並套用不同的縮排值，以示範首行縮排對段落佈局的影響。

建立 Presentation 類別的實例。
取得目標投影片。
在投影片上加入矩形 AutoShape。
為形狀新增空的 TextFrame，並移除預設段落。
建立多個段落，為它們設定不同的 Indent 值。
將段落加入文字框。
儲存已修改的簡報。

以下程式碼示範如何設定段落縮排：

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

    IAutoShape rectangleShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    rectangleShape.getFillFormat().setFillType(FillType.NoFill);
    rectangleShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    rectangleShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    ITextFrame textFrame = rectangleShape.addTextFrame("");
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().removeAt(0);

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.setText("No first-line indent. Wrapped lines start at the same position as the first line.");
    firstParagraph.getParagraphFormat().setMarginLeft(20f);
    firstParagraph.getParagraphFormat().setIndent(0f);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.setText("First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.");
    secondParagraph.getParagraphFormat().setMarginLeft(20f);
    secondParagraph.getParagraphFormat().setIndent(20f);

    Paragraph thirdParagraph = new Paragraph();
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    thirdParagraph.setText("First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.");
    thirdParagraph.getParagraphFormat().setMarginLeft(20f);
    thirdParagraph.getParagraphFormat().setIndent(40f);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);
    textFrame.getParagraphs().add(thirdParagraph);

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

結果：

The first-line indent of the paragraphs

為段落設定懸掛縮排

懸掛縮排是一種段落排版方式，第一行位於其餘行的左側。在 Aspose.Slides 中，可使用 IParagraphFormat.setIndent 方法達成此效果。將縮排設定為負值，即可使第一行相對於段落正文向左移動。

實務上，IParagraphFormat.setMarginLeft 定義段落正文的左側位置，而 IParagraphFormat.setIndent 定義第一行相對於該左側的定位。要建立懸掛縮排，請將 MarginLeft 設為正值，Indent 設為負值。

此格式常用於書目、引用、詞彙表等，需要使換行行對齊於段落正文而非第一行首字的情境。

建立 Presentation 類別的實例。
取得目標投影片。
在投影片上加入矩形 AutoShape。
為形狀新增空的 TextFrame，並移除預設段落。
建立段落，為每個段落設定正的 MarginLeft 值。
設定負的 Indent 值以產生懸掛縮排效果。
將段落加入文字框。
儲存已修改的簡報。

以下程式碼示範如何為段落設定懸掛縮排：

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

    IAutoShape rectangleShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    rectangleShape.getFillFormat().setFillType(FillType.NoFill);
    rectangleShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    rectangleShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    ITextFrame textFrame = rectangleShape.addTextFrame("");
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().removeAt(0);

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.setText("A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body.");
    firstParagraph.getParagraphFormat().setMarginLeft(40f);
    firstParagraph.getParagraphFormat().setIndent(-20f);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.setText("This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare.");
    secondParagraph.getParagraphFormat().setMarginLeft(60f);
    secondParagraph.getParagraphFormat().setIndent(-30f);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);

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

結果：

The hanging indent of the paragraphs

管理段落結束屬性

建立 Presentation 類別的實例。
取得包含段落之投影片的參考（依位置）。
在投影片上加入矩形 autoshape。
為矩形加入含有兩個段落的 TextFrame。
為段落設定 FontHeight 與字型。
為段落設定結束屬性。
將修改後的簡報寫入 PPTX 檔案。

以下 Java 程式碼示範如何為段落設定結束屬性：

Presentation pres = new Presentation();
try {
    IAutoShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);

    Paragraph para1 = new Paragraph();
    para1.getPortions().add(new Portion("Sample text"));

    Paragraph para2 = new Paragraph();
    para2.getPortions().add(new Portion("Sample text 2"));

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(48);
    portionFormat.setLatinFont(new FontData("Times New Roman"));
    para2.setEndParagraphPortionFormat(portionFormat);

    shape.getTextFrame().getParagraphs().add(para1);
    shape.getTextFrame().getParagraphs().add(para2);

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

將 HTML 文字匯入段落

Aspose.Slides 加強了將 HTML 文字匯入段落的支援。

建立 Presentation 類別的實例。
依索引取得目標投影片的參考。
在投影片上加入 autoshape。
為該自動圖形新增並取得 ITextFrame。
移除 ITextFrame 中的預設段落。
以 TextReader 讀取來源 HTML 檔案。
使用 Paragraph 類別建立第一個段落實例。
將讀取的 HTML 內容加入 TextFrame 的 ParagraphCollection。
儲存已修改的簡報。

以下 Java 程式碼示範匯入 HTML 文字至段落的步驟：

// 建立空白簡報實例
Presentation pres = new Presentation();
try {
    // 存取簡報的預設第一張投影片
    ISlide slide = pres.getSlides().get_Item(0);

    // 新增自動圖形以容納 HTML 內容
    IAutoShape ashape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10,
            (float)pres.getSlideSize().getSize().getWidth() - 20, (float)pres.getSlideSize().getSize().getHeight() - 10);

    ashape.getFillFormat().setFillType(FillType.NoFill);

    // 為形狀新增文字框
    ashape.addTextFrame("");

    // 清除已新增文字框中的所有段落
    ashape.getTextFrame().getParagraphs().clear();

    // 使用 StreamReader 載入 HTML 檔案
    TextReader tr = new StreamReader("file.html");

    // 從 HTML StreamReader 中的文字新增至文字框
    ashape.getTextFrame().getParagraphs().addFromHtml(tr.readToEnd());

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

將段落文字匯出為 HTML

Aspose.Slides 加強了將段落文字匯出為 HTML 的支援。

建立 Presentation 類別的實例並載入目標簡報。
依索引取得目標投影片的參考。
取得包含欲匯出文字的圖形。
取得該圖形的 TextFrame。
建立 StreamWriter 實例並新增 HTML 檔案。
提供起始索引給 StreamWriter，並匯出您選取的段落。

以下 Java 程式碼示範如何將 PowerPoint 段落文字匯出為 HTML：

// 載入簡報檔案
Presentation pres = new Presentation("ExportingHTMLText.pptx");
try {
    // 存取簡報的預設第一張投影片
    ISlide slide = pres.getSlides().get_Item(0);

    // 目標索引
    int index = 0;

    // 取得已新增的圖形
    IAutoShape ashape = (IAutoShape) slide.getShapes().get_Item(index);

    // 建立輸出 HTML 檔案
    OutputStream os = new FileOutputStream("output.html");
    Writer writer = new OutputStreamWriter(os, "UTF-8");

    //擷取第一段落為 HTML
    // 透過提供段落起始索引與要複製的總段落數，將段落資料寫入 HTML
    writer.write(ashape.getTextFrame().getParagraphs().exportToHtml(0, ashape.getTextFrame().getParagraphs().getCount(), null));
    writer.close();
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

將段落另存為影像

本節將示範兩個範例，說明如何將代表 IParagraph 介面的文字段落另存為影像。兩個範例皆包括使用 IShape 介面的 getImage 方法取得包含段落之形狀的影像、計算段落在形狀內的範圍，並將其匯出為位圖影像。這些方法可讓您從 PowerPoint 簡報中擷取特定文字部分並另存為單獨影像，以供各種情境使用。

假設我們有一個名為 sample.pptx 的簡報檔案，裡面有一張投影片，第一個形狀是一個包含三個段落的文字方塊。

The text box with three paragraphs

範例 1

此範例取得第二個段落的影像。我們先從簡報的第一張投影片取得形狀的影像，接著計算文字方塊中第二個段落的範圍，然後將段落重新繪製到新的位圖影像中，最後以 PNG 格式儲存。此方法在需要將特定段落另存為獨立影像且保留文字的精確尺寸與格式時非常實用。

Presentation presentation = new Presentation("sample.pptx");
try {
    IAutoShape firstShape = (IAutoShape) presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    // 將形狀儲存為位圖於記憶體中。
    IImage shapeImage = firstShape.getImage();
    ByteArrayOutputStream shapeImageStream = new ByteArrayOutputStream();
    shapeImage.save(shapeImageStream, ImageFormat.Png);
    shapeImage.dispose();

    // 從記憶體建立形狀位圖。
    InputStream shapeImageInputStream = new ByteArrayInputStream(shapeImageStream.toByteArray());
    BufferedImage shapeBitmap = ImageIO.read(shapeImageInputStream);

    // 計算第二段落的邊界。
    IParagraph secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    Rectangle2D paragraphRectangle = secondParagraph.getRect();

    // 計算輸出影像的座標與尺寸（最小尺寸 - 1x1 像素）。
    int imageX = (int) Math.floor(paragraphRectangle.getX());
    int imageY = (int) Math.floor(paragraphRectangle.getY());
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.getWidth()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.getHeight()));

    // 裁切形狀位圖以僅取得段落位圖。
    BufferedImage paragraphBitmap = shapeBitmap.getSubimage(imageX, imageY, imageWidth, imageHeight);

    ImageIO.write(paragraphBitmap, "png", new File("paragraph.png"));
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

結果：

The paragraph image

範例 2

此範例在前述方法基礎上加入縮放因子。先將形狀以縮放因子 2 取得影像，這可在匯出段落時產生更高解析度的輸出。接著計算考慮縮放後的段落範圍。當需要更高細節的影像（例如高品質列印材料）時，縮放尤為有用。

float imageScaleX = 2f;
float imageScaleY = imageScaleX;

Presentation presentation = new Presentation("sample.pptx");
try {
    IAutoShape firstShape = (IAutoShape) presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    // 將形狀以縮放後儲存為位圖於記憶體中。
    IImage shapeImage = firstShape.getImage(ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
    ByteArrayOutputStream shapeImageStream = new ByteArrayOutputStream();
    shapeImage.save(shapeImageStream, ImageFormat.Png);
    shapeImage.dispose();

    // 從記憶體建立形狀位圖。
    InputStream shapeImageInputStream = new ByteArrayInputStream(shapeImageStream.toByteArray());
    BufferedImage shapeBitmap = ImageIO.read(shapeImageInputStream);

    // 計算第二段落的邊界。
    IParagraph secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    Rectangle2D paragraphRectangle = secondParagraph.getRect();
    paragraphRectangle.setRect(
            paragraphRectangle.getX() * imageScaleX,
            paragraphRectangle.getY() * imageScaleY,
            paragraphRectangle.getWidth() * imageScaleX,
            paragraphRectangle.getHeight() * imageScaleY
    );

    // 計算輸出影像的座標與尺寸（最小尺寸 - 1x1 像素）。
    int imageX = (int) Math.floor(paragraphRectangle.getX());
    int imageY = (int) Math.floor(paragraphRectangle.getY());
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.getWidth()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.getHeight()));

    // 裁切形狀位圖以僅取得段落位圖。
    BufferedImage paragraphBitmap = shapeBitmap.getSubimage(imageX, imageY, imageWidth, imageHeight);

    ImageIO.write(paragraphBitmap, "png", new File("paragraph.png"));
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

常見問題

可以完全停用文字框內的自動換行嗎？

可以。使用文字框的換行設定 (setWrapText) 將換行關閉，即可避免文字在框邊緣斷行。

如何取得特定段落在投影片上的精確邊界？

您可以取得段落（甚至單一 Portion）的邊界矩形，以得知其在投影片上的確切位置與大小。

段落對齊方式（左/右/置中/分散）在哪裡設定？

Alignment 是位於 ParagraphFormat 的段落層級設定，會套用於整個段落，不受單一 Portion 的格式影響。

可以只為段落中的某個詞設定拼寫檢查語言嗎？

可以。語言設定位於 Portion 層級 (PortionFormat.setLanguageId)，因此同一段落中可以同時存在多種語言。

使用 Java 的 AutoFit 強化您的簡報在 Java 簡報中取得段落邊界