管理 Android 上的 PowerPoint 文字段落

簡介

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

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

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

新增包含多個文字片段的多個段落

這些步驟示範如何新增包含 3 個段落、且每個段落包含 3 個文字片段的文字框：

建立 Presentation 類別的實例。
透過索引存取相關投影片的參考。
在投影片上新增一個矩形 IAutoShape。
取得與 IAutoShape 相關聯的 ITextFrame。
建立兩個 IParagraph 物件，並將它們加入 ITextFrame 的 IParagraphs 集合中。
為每個新建立的 IParagraph 建立三個 IPortion 物件（預設段落有兩個 Portion 物件），並將每個 IPortion 物件加入各自 IParagraph 的 IPortion 集合中。
為每個 Portion 設定文字。
使用 IPortion 物件提供的格式屬性，為每個 Portion 套用您偏好的格式設定。
儲存已修改的簡報。

// 實例化代表 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();

    // 建立具有不同文字格式的段落和文字片段
    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 類別的實例。
透過索引存取相關投影片的參考。
在投影片上新增 autoshape。
取得 autoshape 的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例。
將段落的項目符號 Type 設為 Symbol，並設定項目符號字元。
設定段落的 Text。
設定段落的項目符號 Indent。
設定項目符號的顏色。
設定項目符號的高度。
將新段落加入 TextFrame 的段落集合中。
加入第二個段落，並重複步驟 7 至 12 的操作。
儲存簡報。

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

    // 取得 AutoShape 的文字框
    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 類別的實例。
透過索引存取相關投影片的參考。
在投影片上新增 autoshape。
取得 autoshape 的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例。
在 IPPImage 中載入圖片。
將項目符號類型設定為 Picture，並設定圖片。
設定段落的 Text。
設定段落的項目符號 Indent。
設定項目符號的顏色。
設定項目符號的高度。
將新段落加入 TextFrame 的段落集合中。
加入第二個段落，並依照前述步驟重複操作。
儲存已修改的簡報。

// 實例化代表 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();
    }
    // 新增並存取 AutoShape
    IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // 取得 AutoShape 的文字框
    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 類別的實例。
透過索引存取相關投影片的參考。
在新投影片中新增 autoshape。
取得 autoshape 的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例，並將深度設定為 0。
使用 Paragraph 類別建立第二個段落實例，並將深度設定為 1。
使用 Paragraph 類別建立第三個段落實例，並將深度設定為 2。
使用 Paragraph 類別建立第四個段落實例，並將深度設定為 3。
將新段落加入 TextFrame 的段落集合中。
儲存已修改的簡報。

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

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

    // 取得已建立 AutoShape 的文字框
    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 類別的實例。
取得包含該段落的投影片。
在投影片上新增 autoshape。
取得 autoshape 的 TextFrame。
移除 TextFrame 中的預設段落。
使用 Paragraph 類別建立第一個段落實例，並將 NumberedBulletStartWith 設為 2。
使用 Paragraph 類別建立第二個段落實例，並將 NumberedBulletStartWith 設為 3。
使用 Paragraph 類別建立第三個段落實例，並將 NumberedBulletStartWith 設為 7。
將新段落加入 TextFrame 的段落集合中。
儲存已修改的簡報。

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

    // 取得已建立 AutoShape 的文字框
    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();
}

段落的首行縮排

設定段落的懸掛縮排

懸掛縮排是一種段落版面配置，第一行位於其餘行的左側。在 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();
}

段落的懸掛縮排

管理段落結束執行屬性

建立 Presentation 類別的實例。
透過位置取得包含該段落的投影片參考。
在投影片上新增矩形 [autoshape]。
在矩形中加入包含兩個段落的 [TextFrame]。
為段落設定 FontHeight 與字型類型。
設定段落的結束屬性。
將已修改的簡報寫入為 PPTX 檔案。

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。
新增並取得 autoshape 的 ITextFrame。
移除 ITextFrame 中的預設段落。
使用 TextReader 讀取來源 HTML 檔案。
使用 Paragraph 類別建立第一個段落實例。
將已讀取的 TextReader 中的 HTML 檔案內容新增至 TextFrame 的 ParagraphCollection。
儲存已修改的簡報。

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

    // 新增 AutoShape 以容納 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();

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

    // 將 HTML 串流讀取器的文字加入文字框
    ashape.getTextFrame().getParagraphs().addFromHtml(tr.readToEnd());

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

將段落文字匯出為 HTML

Aspose.Slides 提供加強的段落文字匯出至 HTML 的支援。

建立 Presentation 類別的實例並載入目標簡報。
透過索引存取相關投影片的參考。
取得將要匯出為 HTML 的文字所在的形狀。
取得形狀的 TextFrame。
建立 StreamWriter 實例，並新增 HTML 檔案。
提供起始索引給 StreamWriter，並匯出您選擇的段落。

// 載入簡報檔案
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 的簡報檔案，內含一張投影片，而第一個形狀是一個包含三個段落的文字方塊。

包含三個段落的文字方塊

範例 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);
    RectF paragraphRectangle = secondParagraph.getRect();

    // 計算輸出影像的座標與大小（最小尺寸為 1x1 像素）。
    int imageX = (int) Math.floor(paragraphRectangle.left);
    int imageY = (int) Math.floor(paragraphRectangle.top);
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.width()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.height()));

    // 裁切形狀位圖以僅取得段落位圖。
    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();
}

段落影像

範例 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);
    RectF paragraphRectangle = secondParagraph.getRect();
    paragraphRectangle.set(
            paragraphRectangle.left * imageScaleX,
            paragraphRectangle.top * imageScaleY,
            paragraphRectangle.right * imageScaleX,
            paragraphRectangle.bottom * imageScaleY
    );

    // 計算輸出影像的座標與大小（最小尺寸為 1x1 像素）。
    int imageX = (int) Math.floor(paragraphRectangle.left);
    int imageY = (int) Math.floor(paragraphRectangle.top);
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.width()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.height()));

    // 裁切形狀位圖以僅取得段落位圖。
    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)，因此單一段落內可同時存在多種語言。

使用 Android 上的 AutoFit 增強您的簡報在 Android 上從簡報取得段落邊界