管理 Java 中的 PowerPoint 文本段落

本页内容简介

了解如何使用 Aspose.Slides for Java 创建和格式化段落、部分、项目符号、编号列表、缩进、HTML 内容以及段落图像。

概览

Aspose.Slides for Java 将文本表示为文本框、段落和部分的层次结构：

ITextFrame 表示形状中的文本容器并提供对其段落集合的访问。
IParagraph 表示文本框中的一个段落，并提供对其部分和段落级别格式的访问。
IPortion 表示段落中的一段文本运行。每个部分可以拥有自己的文本和字符级别的格式。

因此，一个段落可以通过使用多个部分来包含具有不同字体、颜色、大小和其他格式的文本。

创建和格式化段落

在形状的文本框中创建段落并使用部分来格式化各个文本运行。本节展示如何在每个段落中组合多个部分并应用不同的颜色、字体大小和样式。

使用多个部分创建段落

下面的 Java 示例创建了三个段落，每个段落在由 IParagraph.getPortions 返回的集合中包含三个文本运行。它复用默认段落及其空白部分，然后添加其余的段落和部分。格式通过 IPortion.getPortionFormat 应用：每个段落的第一部分为红色、粗体、15 磅；第二部分为蓝色、斜体、18 磅。第三部分保留其默认格式：

import com.aspose.slides.*;
import java.awt.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);
    ITextFrame textFrame = shape.getTextFrame();

    IParagraph firstParagraph = textFrame.getParagraphs().get_Item(0);
    firstParagraph.getPortions().add(new Portion());
    firstParagraph.getPortions().add(new Portion());

    IParagraph secondParagraph = new Paragraph();
    secondParagraph.getPortions().add(new Portion());
    secondParagraph.getPortions().add(new Portion());
    secondParagraph.getPortions().add(new Portion());
    textFrame.getParagraphs().add(secondParagraph);

    IParagraph thirdParagraph = new Paragraph();
    thirdParagraph.getPortions().add(new Portion());
    thirdParagraph.getPortions().add(new Portion());
    thirdParagraph.getPortions().add(new Portion());
    textFrame.getParagraphs().add(thirdParagraph);

    int paragraphCount = textFrame.getParagraphs().getCount();
    for (int paragraphIndex = 0; paragraphIndex < paragraphCount; paragraphIndex++) {
        IParagraph paragraph = textFrame.getParagraphs().get_Item(paragraphIndex);
        int portionCount = paragraph.getPortions().getCount();
        for (int portionIndex = 0; portionIndex < portionCount; portionIndex++) {
            IPortion portion = paragraph.getPortions().get_Item(portionIndex);
            portion.setText("Portion " + (paragraphIndex + 1) + "." + (portionIndex + 1));

            if (portionIndex == 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 (portionIndex == 1) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
                portion.getPortionFormat().setFontItalic(NullableBool.True);
                portion.getPortionFormat().setFontHeight(18);
            }
        }
    }

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

创建项目符号和编号列表

将段落文本组织为具有符号、数字或自定义图像的列表。本节的示例涵盖项目符号格式、多级列表和自定义起始编号。

创建项目符号或编号列表

项目符号和编号使相关项目更易于浏览。在 Aspose.Slides 中，列表设置通过 IBulletFormat 定义。

此 Java 示例向同一文本框添加了符号项目符号和编号项。IBulletFormat.setType 选择项目符号类型，而 IBulletFormat.setChar 提供符号且 IBulletFormat.setNumberedBulletStyle 选择编号样式。两个项目均使用黑色项目符号，高度为 100%，段落缩进为 25 磅：

import com.aspose.slides.*;
import java.awt.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph symbolParagraph = new Paragraph();
    symbolParagraph.setText("Welcome to Aspose.Slides");
    symbolParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    symbolParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    symbolParagraph.getParagraphFormat().setIndent(25);
    symbolParagraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    symbolParagraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    symbolParagraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True);
    symbolParagraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(symbolParagraph);

    Paragraph numberedParagraph = new Paragraph();
    numberedParagraph.setText("This is a numbered item");
    numberedParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    numberedParagraph.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain);
    numberedParagraph.getParagraphFormat().setIndent(25);
    numberedParagraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    numberedParagraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    numberedParagraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True);
    numberedParagraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(numberedParagraph);

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

使用图片项目符号

图片项目符号允许使用自定义图像替代符号或数字。

此 Java 示例将图像作为 IPPImage 添加到演示文稿的图像集合中，并将其用作段落项目符号。它调用 IBulletFormat.setType 使用图片项目符号，并通过 IBulletFormat.getPicture 分配图像。IBulletFormat.setHeight 设置为 100% 来相对于段落文本调整项目符号的大小：

import com.aspose.slides.*;

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

    IImage bulletImage = Images.fromFile("bullets.png");
    IPPImage presentationImage;
    try {
        presentationImage = presentation.getImages().addImage(bulletImage);
    } finally {
        bulletImage.dispose();
    }

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph paragraph = new Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(presentationImage);
    paragraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(paragraph);

    presentation.save("picture_bullet.pptx", SaveFormat.Pptx);
    presentation.save("picture_bullet.ppt", SaveFormat.Ppt);
} finally {
    presentation.dispose();
}

创建多级列表

设置 IParagraphFormat.setDepth 将段落放置在列表的不同层级。顶层的深度为 0。

此 Java 示例为四个段落分配从 0 到 3 的 IParagraphFormat.setDepth 值，在同一个文本框中创建层次结构。每个段落使用符号项目符号，并通过 IBulletFormat.setChar 在圆形项目符号和连字符之间交替，以区分相邻层级：

import com.aspose.slides.*;
import java.awt.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    IParagraph firstParagraph = new Paragraph();
    firstParagraph.setText("Content");
    firstParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    firstParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.getParagraphFormat().setDepth((short) 0);

    IParagraph secondParagraph = new Paragraph();
    secondParagraph.setText("Second level");
    secondParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    secondParagraph.getParagraphFormat().getBullet().setChar('-');
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.getParagraphFormat().setDepth((short) 1);

    IParagraph thirdParagraph = new Paragraph();
    thirdParagraph.setText("Third level");
    thirdParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    thirdParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    thirdParagraph.getParagraphFormat().setDepth((short) 2);

    IParagraph fourthParagraph = new Paragraph();
    fourthParagraph.setText("Fourth level");
    fourthParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    fourthParagraph.getParagraphFormat().getBullet().setChar('-');
    fourthParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    fourthParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    fourthParagraph.getParagraphFormat().setDepth((short) 3);

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

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

自定义起始值的编号列表项

使用 IBulletFormat.setNumberedBulletStartWith 设置编号段落显示的起始编号。

此 Java 示例将 IBulletFormat.setType 设置为对三个段落使用编号，并为 IBulletFormat.setNumberedBulletStartWith 分别赋值 2、3 和 7。起始值针对每个段落单独配置，允许显示的编号跳过值：

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.setText("Start at 2");
    firstParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    firstParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 2);
    textFrame.getParagraphs().add(firstParagraph);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.setText("Start at 3");
    secondParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    secondParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 3);
    textFrame.getParagraphs().add(secondParagraph);

    Paragraph thirdParagraph = new Paragraph();
    thirdParagraph.setText("Start at 7");
    thirdParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    thirdParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 7);
    textFrame.getParagraphs().add(thirdParagraph);

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

控制段落布局和结束属性

调整段落边距和缩进以控制首行和换行行的位置。还可以单独格式化段落结束标记，而不影响可见的文本部分。

设置首行缩进

使用 IParagraphFormat.setIndent 方法控制段落的首行缩进。此设置仅相对于段落左边距移动首行。正值会将首行向右移动，而其余行保持与段落正文对齐。

当需要移动整个段落时使用 IParagraphFormat.setMarginLeft；当只需移动首行时使用 IParagraphFormat.setIndent。

下面的示例为三个段落设置相同的 IParagraphFormat.setMarginLeft 为 20 磅，并将 IParagraphFormat.setIndent 的值分别设为 0、20 和 40 磅。首行以逐渐增大的偏移开始，而换行行保留相同的左边距：

import com.aspose.slides.*;
import java.awt.Color;

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

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

    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().clear();

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

    Paragraph secondParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.getParagraphFormat().setMarginLeft(20f);
    secondParagraph.getParagraphFormat().setIndent(20f);

    Paragraph thirdParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    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 属性实现此效果。将 Indent 设置为负值可使首行相对于段落正文左移。

实际上，IParagraphFormat.setMarginLeft 定义段落正文的左侧位置，而 IParagraphFormat.setIndent 定义首行相对于该边距的位置。要创建悬挂缩进，需将 MarginLeft 设置为正值，将 Indent 设置为负值。

此格式对于参考文献、引用、词汇表条目以及其他需要换行行在段落正文下对齐而非首行首字符下的段落很有用。

下面的 Java 示例将 IParagraphFormat.setMarginLeft 的值设为 40 和 60 磅，并将 IParagraphFormat.setIndent 的值设为 -20 和 -30 磅。每个段落的首行都位于换行行的左侧；第二个段落的悬挂缩进更深：

import com.aspose.slides.*;
import java.awt.Color;

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

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

    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.getParagraphFormat().setMarginLeft(40f);
    firstParagraph.getParagraphFormat().setIndent(-20f);

    Paragraph secondParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    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();
}

结果：

段落的悬挂缩进

设置段落结束运行属性

IParagraph.setEndParagraphPortionFormat 方法控制段落结束标记的格式。下面的示例创建了一个 PortionFormat，其中 IBasePortionFormat.setFontHeight 设置为 48 磅，且 IBasePortionFormat.setLatinFont 设置为 Times New Roman。它将此格式分配给第二段落的结束标记，而可见的文本部分保持不变：

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

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

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

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

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

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

计数渲染行数

有关影响自动换行和行尾标点的段落规则，请参阅 Control Line Breaking 和 Control Hanging Punctuation。

使用 IParagraph.getLinesCount 可以统计段落在文本布局后占用的行数，包括自动换行。这在检查演示文稿模板中的文本长度和布局时非常有用。

段落是 ITextFrame.getParagraphs 中的一个项目，且它可能占用多行渲染的行。段落中的显式换行会强制换到新行，但不会创建另一个段落。自动换行根据可用宽度创建行，而不在文本中插入显式换行符。因此，仅统计段落数或换行字符并不能得到渲染的行数。

下面的示例创建一个文本形状，统计其行数，缩小形状宽度，然后用更短的字符串替换文本。示例通过 ITextFrameFormat.setWrapText 启用换行，并通过 ITextFrameFormat.setAutofitType 禁用自动适配，以便形状宽度控制换行而不自动缩小文本或调整形状大小。每次测量都使用 IParagraph.getLinesCount。形状尺寸单位为磅。最后，示例再添加一个段落并对文本框的行数求和。

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);

    IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
    paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20);
    paragraph.setText("This text demonstrates how automatic wrapping changes the number of rendered lines.");
    System.out.println("Original width: " + paragraph.getLinesCount());

    shape.setWidth(150);
    System.out.println("Narrower shape: " + paragraph.getLinesCount());

    paragraph.setText("Short text.");
    System.out.println("Shorter text: " + paragraph.getLinesCount());

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.setText("Another paragraph.");
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20);
    textFrame.getParagraphs().add(secondParagraph);

    int totalLineCount = 0;
    for (IParagraph currentParagraph : textFrame.getParagraphs()) {
        totalLineCount += currentParagraph.getLinesCount();
    }
    System.out.println("Total lines in the text frame: " + totalLineCount);
} finally {
    presentation.dispose();
}

使用此文本和这些尺寸时，缩小形状会增加行数，而用短字符串替换文本会减少行数。准确的计数可能因字体可用性及替代、字体大小、边距、缩进、换行和自动适配设置而有所不同。检查模板时请使用针对目标环境的字体和布局设置。

仅凭行数并不能判断文本是否溢出容器。可用高度、行高、段落和行间距以及自动适配行为也会影响；即使是单行文本，在禁用换行时也可能超过可用宽度。

导入和导出段落内容

使用 HTML 将文本导入演示文稿，或导出现有段落供外部使用。本节还展示如何将单个段落渲染为图像，包括表格单元格中的段落。

将 HTML 文本导入段落

使用 ParagraphCollection.addFromHtml 将 HTML 标记转换为文本框中的段落和部分。

此 Java 示例从文件读取 HTML 并将标记传递给 ParagraphCollection.addFromHtml。它清除文本框的默认段落，使框仅包含导入的内容。矩形形状在幻灯片的每侧留下 10 磅的边距：

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    float shapeWidth = (float) presentation.getSlideSize().getSize().getWidth() - 20;
    float shapeHeight = (float) presentation.getSlideSize().getSize().getHeight() - 20;
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, shapeWidth, shapeHeight);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getTextFrame().getParagraphs().clear();

    try {
        byte[] htmlBytes = Files.readAllBytes(Paths.get("file.html"));
        String html = new String(htmlBytes, StandardCharsets.UTF_8);
        shape.getTextFrame().getParagraphs().addFromHtml(html);
        presentation.save("html_text.pptx", SaveFormat.Pptx);
    } catch (IOException exception) {
        System.out.println("The HTML file could not be read: " + exception.getMessage());
    }
} finally {
    presentation.dispose();
}

导出段落文本为 HTML

使用 ParagraphCollection.exportToHtml 将选定范围的段落导出为 HTML。当在网站上重复使用演示文稿文本时，您可能希望保留本地强调，而不继承演示文稿的字体、大小或文本框样式。设置 TextToHtmlConversionOptions.setTextInheritanceLimit 可控制导出程序遵循格式继承的程度。

下载示例演示文稿并将其放置在应用程序的工作目录中。其第一页包含一个包含文本 “Inherited text; explicit red 18pt” 的文本形状。输入故意使用了多个格式层级：

演示文稿的默认文本样式提供 Calibri 字体，大小为 28 磅。
文本框的一层文本样式提供蓝色文本和斜体。
段落显式设置粗体文本。
第二部分 “explicit red 18pt” 显式设置为红色文本，大小为 18 磅。

以下完整示例将相同的段落导出三次。它将 TextToHtmlConversionOptions 传递给导出方法，并将每个结果写入单独的 UTF-8 HTML 文件：

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

Presentation presentation = new Presentation("text-inheritance.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    if (shape instanceof IAutoShape) {
        IAutoShape textShape = (IAutoShape) shape;
        ITextFrame textFrame = textShape.getTextFrame();
        if (textFrame != null) {
            IParagraphCollection paragraphs = textFrame.getParagraphs();
            
            int[] modes = { TextInheritanceLimit.All, TextInheritanceLimit.TextBox, TextInheritanceLimit.ParagraphOnly };
            String[] fileNames = { "All.html", "TextBox.html", "ParagraphOnly.html" };

            for (int i = 0; i < modes.length; i++) {
                TextToHtmlConversionOptions options = new TextToHtmlConversionOptions();
                options.setTextInheritanceLimit(modes[i]);

                String html = paragraphs.exportToHtml(0, paragraphs.getCount(), options);
                byte[] htmlBytes = html.getBytes(StandardCharsets.UTF_8);
                try {
                    Files.write(Paths.get(fileNames[i]), htmlBytes);
                } catch (IOException exception) {
                    System.out.println("The HTML file could not be written: " + exception.getMessage());
                }
            }
        } else {
            System.out.println("The first shape does not contain a text frame.");
        }
    } else {
        System.out.println("The first shape is not a text shape.");
    }
} finally {
    presentation.dispose();
}

生成的 HTML 包含以下针对第一部分 “Inherited text; " 的 CSS。表格列出了相关声明；其他生成的属性为简洁起见已省略。

输出	第一部分的相关 CSS	外观
`All.html`	`font-family:'Calibri'; font-size:28pt; color:#0000ff; font-style:italic; font-weight:bold`	蓝色、粗体、斜体文本，28 磅 Calibri（如果该字体可用）。
`TextBox.html`	`color:#0000ff; font-style:italic; font-weight:bold`	蓝色、粗体、斜体文本；字体族和大小由页面或浏览器提供。
`ParagraphOnly.html`	`font-weight:bold`	粗体文本；字体族、大小、颜色和斜体样式由页面或浏览器提供。

第二部分在所有三个输出中均保留 color:#ff0000、font-size:18pt 和 font-weight:bold。它在 All 和 TextBox 中也保留斜体，但在 ParagraphOnly 中不保留。因此，限制继承并不会移除显式分配给段落或部分的格式。

在同一浏览器中打开这些文件以进行比较。在两种受限模式下，省略的 CSS 属性由目标页面的样式或浏览器默认值解析，因此最终外观取决于 HTML 的使用位置。

将段落渲染为图像

IParagraph.getImage 直接渲染单个段落并返回一个 IImage。使用 IImage.save 将结果保存到文件或流。无需渲染包含的形状或手动裁剪位图。

IParagraph.getImage 如果段落在其父集合中找不到、没有有效的渲染边界或无法渲染，则可能返回 null。在保存之前检查结果，并在使用后释放返回的图像。

以默认比例渲染段落

示例使用一个包含一个幻灯片的演示文稿，其第一个形状是包含三个段落的文本框。

包含三个段落的文本框

下面的示例选择索引为 1 的第二个段落，并在不传递比例参数的情况下调用 IParagraph.getImage。它在调用 IImage.save 以 PNG 格式保存之前，检查形状是否包含所需段落以及渲染是否返回图像。finally 块在使用后释放图像。

import com.aspose.slides.*;

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

    if (shape instanceof IAutoShape) {
        IAutoShape textShape = (IAutoShape) shape;
        ITextFrame textFrame = textShape.getTextFrame();
        if (textFrame != null && textFrame.getParagraphs().getCount() > 1) {
            IParagraph paragraph = textFrame.getParagraphs().get_Item(1);
            IImage paragraphImage = paragraph.getImage();

            if (paragraphImage != null) {
                try {
                    paragraphImage.save("paragraph.png", ImageFormat.Png);
                } finally {
                    paragraphImage.dispose();
                }
            } else {
                System.out.println("The paragraph could not be rendered.");
            }
        } else {
            System.out.println("The expected paragraph was not found.");
        }
    } else {
        System.out.println("The first shape is not a text shape.");
    }
} finally {
    presentation.dispose();
}

结果：

段落图像

在表格单元格中按比例渲染段落

使用接受 float scaleX 和 float scaleY 参数的 IParagraph.getImage 重载来设置水平和垂直比例因子。下面的示例创建一个表格，在其第一个单元格中以默认宽高的两倍渲染段落，并将结果保存为 PNG 图像。

import com.aspose.slides.*;

float scaleX = 2f;
float scaleY = 2f;

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

    ITable table = slide.getShapes().addTable(50, 50, new double[] { 300 }, new double[] { 80 });
    IParagraph paragraph = table.get_Item(0, 0).getTextFrame().getParagraphs().get_Item(0);
    paragraph.setText("Text in a table cell");

    IImage paragraphImage = paragraph.getImage(scaleX, scaleY);
    if (paragraphImage != null) {
        try {
            paragraphImage.save("table_paragraph.png", ImageFormat.Png);
        } finally {
            paragraphImage.dispose();
        }
    } else {
        System.out.println("The paragraph could not be rendered.");
    }
} finally {
    presentation.dispose();
}

1 的比例因子保持该轴的默认像素尺寸。例如，两个因子均为 2 会生成宽高约为默认尺寸两倍的图像，像素数量为原来的四倍。较大的因子通常会产生更清晰的文本，适用于放大或高分辨率输出，但也会增加内存使用和文件大小。小于 1 的因子会生成细节较少的更小图像。使用相等的因子可保持段落的宽高比；不同的水平和垂直因子会分别拉伸输出。

在需要包含形状填充、边框或其他视觉上下文的输出时，使用 IShape.getImage 渲染整个形状仍然有用。若仅需段落图像，请使用 IParagraph.getImage。

FAQ

我能完全禁用文本框内的自动换行吗？

可以。将 ITextFrameFormat.setWrapText 设置为禁用换行，使行不会在文本框边缘断开。

如何获取特定段落在幻灯片上的精确边界？

使用 IParagraph.getRect 获取段落的边界矩形。 IPortion.getRect 提供单个部分的边界。

段落对齐（左、右、居中或两端对齐）在哪里控制？

IParagraphFormat.setAlignment 是段落级别的设置，适用于整个段落，无论各部分的格式如何。

要在每行内垂直对齐不同字体大小的部分，请参阅 Align Fonts Within a Line。

我能为段落的一部分设置校对语言吗？

可以。对各个部分使用 IBasePortionFormat.setLanguageId 设置语言 ID，这样一个段落可以包含多种语言的文本。

使用 Java 中的 AutoFit 提升您的演示文稿在 Java 中获取演示文稿的段落边界