在 Python via Java 中格式化演示文稿文本
概述
本文展示了如何使用 Aspose.Slides for Python via Java 对 PowerPoint 和 OpenDocument 演示文稿中的文本进行格式化。内容包括背景颜色、透明度、字符间距、字体属性、旋转、段落间距、自动适应行为、文本锚定、制表位和语言设置。
除非另有说明,示例均使用 sample.pptx。它的第一张幻灯片的第一个形状是文本框,首段包含如下所示文本。幻灯片和形状的索引均为零基。选择粗体部分的示例使用有效格式,包括继承的粗体格式:

要查找并高亮文字字面值或正则表达式匹配,请参阅 Search and Replace Text。
设置文本背景颜色
使用 ParagraphFormat.getDefaultPortionFormat 为段落设置默认的突出显示颜色,或使用 BasePortionFormat.getHighlightColor 为单独的文本片段设置突出显示颜色。
下面的示例将浅灰色突出显示设置为第一段的默认颜色。对单独片段的显式突出显示颜色会优先于该默认值:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
from java.awt import Color
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# 为整个段落设置突出显示颜色。
paragraph.getParagraphFormat().getDefaultPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY)
presentation.save("gray_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

下面的代码示例演示如何为 加粗字体的文本片段 设置背景颜色:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpile.startJVM()
from asposeslides.api import Presentation, SaveFormat
from java.awt import Color
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# 为文本片段设置突出显示颜色。
portion.getPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY)
presentation.save("gray_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

对齐文本段落
使用 ParagraphFormat.setAlignment 设置文本框内段落的对齐方式。值可以是居中、左对齐、右对齐、两端对齐等。
下面的代码示例展示如何将段落对齐到 居中:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextAlignment
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# 将段落对齐方式设置为居中。
paragraph.getParagraphFormat().setAlignment(TextAlignment.Center)
presentation.save("aligned_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

在行内对齐字体
使用 ParagraphFormat.setFontAlignment 在一行中对不同字号的文本片段进行垂直对齐。此设置作用于整个段落,并控制每行内部的对齐方式。
下面的独立示例在同一张幻灯片上创建四个带标签的文本框。每个段落以 18、36、54 磅的相同文本显示,且使用不同的字体对齐方式。示例使用 Arial,禁用自动适应和换行,并保持文本框足够大以容纳单行。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontAlignment, FontData, NullableBool, Paragraph, Portion, Presentation, SaveFormat, ShapeType, TextAlignment, TextAnchorType, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
alignments = [FontAlignment.Baseline, FontAlignment.Top, FontAlignment.Center, FontAlignment.Bottom]
alignment_names = ["Baseline", "Top", "Center", "Bottom"]
font_sizes = [18.0, 36.0, 54.0]
font = FontData("Arial")
for i, alignment in enumerate(alignments):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 20 + i * 130, 660, 120)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setWrapText(NullableBool.False_)
label = text_frame.getParagraphs().get_Item(0)
label.setText(alignment_names[i])
label.getParagraphFormat().setAlignment(TextAlignment.Left)
label.getParagraphFormat().getDefaultPortionFormat().setFontHeight(14)
label.getParagraphFormat().getDefaultPortionFormat().setLatinFont(font)
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY)
paragraph = Paragraph()
paragraph.getParagraphFormat().setFontAlignment(alignment)
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left)
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(font)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
for font_size in font_sizes:
portion = Portion("Ag ")
portion.getPortionFormat().setFontHeight(font_size)
paragraph.getPortions().add(portion)
text_frame.getParagraphs().add(paragraph)
presentation.save("font_alignment.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

字体对齐使用字体度量,因此各字母的可见边缘不一定完全对齐。示例中包含大写字母和下垂字符,以帮助显示基线与底部对齐之间的差异。字体可用性与替代、所使用的字符以及字号差异都会影响结果。框架尺寸、边距、行距、换行和自动适应也会影响布局;比较模式时请使用相同的字体和布局设置。
此设置不同于 ParagraphFormat.setAlignment,后者控制水平段落对齐;亦不同于 TextFrameFormat.setAnchoringType,后者在形状内部垂直定位文本块。通过 BasePortionFormat.setEscapement 实现的上标和下标格式会相对于基线移动单个片段,而不是为段落的行设置字体对齐。
设置文本透明度
文本透明度通过分配给 BasePortionFormat.getFillFormat 的颜色的 alpha 分量进行控制。在下列示例中,alpha = 50 是 0–255 范围的 ARGB alpha 通道值,而非透明度百分比。
下面的代码示例展示如何为 整个段落 应用透明度:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat
from java.awt import Color
alpha = 50
text_color = Color(0, 0, 0, alpha)
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# 将文本的填充颜色设置为透明颜色。
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(text_color)
presentation.save("transparent_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

下面的代码示例展示如何为 加粗字体的文本片段 应用透明度:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat
from java.awt import Color
alpha = 50
text_color = Color(0, 0, 0, alpha)
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# 设置文本片段的透明度。
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(text_color)
presentation.save("transparent_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

设置文本字符间距
使用 BasePortionFormat.setSpacing 扩展或压缩文本框中字符之间的间距。示例中添加 3 磅间距;负值会压缩文本。
下面的 Python 代码展示如何在 整个段落 中扩展字符间距:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# 注意: 使用负值来压缩字符间距。
paragraph.getParagraphFormat().getDefaultPortionFormat().setSpacing(3) # 扩展字符间距。
presentation.save("character_spacing_in_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

下面的代码示例展示如何在 加粗字体的文本片段 中扩展字符间距:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# 注意: 使用负值来压缩字符间距。
portion.getPortionFormat().setSpacing(3) # 扩展字符间距。
presentation.save("character_spacing_in_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

为特定字体禁用连字
在某些情况下,Aspose.Slides 渲染的文本可能比 PowerPoint 中显示的稍紧。这可能是因为 PowerPoint 对某些字体会忽略连字数据,即使该字体包含有效的连字信息且 PowerPoint 设置中已启用连字。
为使渲染结果更接近 PowerPoint,可为使用受影响字体的文本片段禁用连字。将 BasePortionFormat.setKerningMinimalSize 设置为大于实际字号的值。本示例需要 “presentation.pptx”,其中第一张幻灯片的第一形状是文本框。它检查有效字体名称(包括继承的字体),并为使用 Roboto 的片段设置 100 磅的阈值:低于此阈值的片段将禁用连字:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
target_font = "Roboto"
for paragraph in auto_shape.getTextFrame().getParagraphs():
for portion in paragraph.getPortions():
portion_format = portion.getPortionFormat().getEffective()
fonts = (portion_format.getLatinFont(), portion_format.getEastAsianFont(), portion_format.getComplexScriptFont())
if any(font is not None and font.getFontName() == target_font for font in fonts):
portion.getPortionFormat().setKerningMinimalSize(100)
presentation.save("output.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
对于低于阈值的匹配文本,此设置可防止连字,并帮助使 Aspose.Slides 的渲染效果与 PowerPoint 在受此 PowerPoint 特定行为影响的字体的视觉输出保持一致。
管理文本字体属性
可以通过 ParagraphFormat.getDefaultPortionFormat 在段落级别设置字体属性,或通过 PortionFormat 在单个片段上设置。
下面的示例将第一段的默认字体设置为 12 磅 Times New Roman,并使用粗体、斜体和点状下划线。对单个片段的显式格式会优先于这些默认值:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, NullableBool, Presentation, SaveFormat, TextUnderlineType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# 为段落设置字体属性。
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(12)
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontBold(NullableBool.True_)
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontItalic(NullableBool.True_)
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontUnderline(TextUnderlineType.Dotted)
font = FontData("Times New Roman")
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(font)
presentation.save("font_properties_for_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

下面的示例对有效格式为粗体的片段应用 13 磅 Times New Roman、斜体以及点状下划线:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, NullableBool, Presentation, SaveFormat, TextUnderlineType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# 为文本片段设置字体属性。
portion.getPortionFormat().setFontHeight(13)
portion.getPortionFormat().setFontItalic(NullableBool.True_)
portion.getPortionFormat().setFontUnderline(TextUnderlineType.Dotted)
font = FontData("Times New Roman")
portion.getPortionFormat().setLatinFont(font)
presentation.save("font_properties_for_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

控制文本高度归一化
在复现模板排版或调查字符高度差异时使用 BasePortionFormat.setNormaliseHeight。在 PowerPoint 中,启用归一化会在垂直方向拉伸或压缩单个字符,使其在文本片段内呈现统一的可见高度,但不保证不同字体之间的文本高度相等。
将属性设置为 NullableBool.True_ or False_ 可显式启用或禁用归一化。NullableBool.NotDefined 表示本地设置未定义,片段将继承其值,例如来自段落的 getDefaultPortionFormat。这并不等同于 False。使用 PortionFormat.getEffective 并读取返回的有效格式的 getNormaliseHeight 可获得解析后的布尔值。
下面的独立示例需要安装 Arial。它创建两个文本块,包含相同的大写字母、小写字母、下垂字符和带重音字符,字号为 54 磅。两段默认启用归一化。上部片段显式禁用,下部片段继承设置。框架大小、边距和段落间距相同,且禁用换行和自动适应,以保持比较一致。示例输出 False: False 和 NotDefined: True,并保存为 “text_height_normalization.pptx”。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpile.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Presentation, SaveFormat, ShapeType, TextAlignment, TextAnchorType, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
settings = [NullableBool.False_, NullableBool.NotDefined]
setting_names = ["False", "NotDefined"]
for i, setting in enumerate(settings):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 60 + i * 200, 660, 150)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.setText("Hxgjpq ÅÉ 0123")
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setWrapText(NullableBool.False_)
text_frame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
text_frame.getTextFrameFormat().setMarginTop(0)
text_frame.getTextFrameFormat().setMarginLeft(0)
paragraph = text_frame.getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left)
paragraph.getParagraphFormat().setSpaceBefore(0)
paragraph.getParagraphFormat().setSpaceAfter(0)
paragraph.getParagraphFormat().setSpaceWithin(100)
paragraph.getParagraphFormat().getDefaultPortionFormat().setNormaliseHeight(NullableBool.True_)
portion = paragraph.getPortions().get_Item(0)
font = FontData("Arial")
portion.getPortionFormat().setLatinFont(font)
portion.getPortionFormat().setFontHeight(54)
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
portion.getPortionFormat().setNormaliseHeight(setting)
print(f"{setting_names[i]}: {bool(portion.getPortionFormat().getEffective().getNormaliseHeight())}")
presentation.save("text_height_normalization.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
下面的比较图是从保存的演示文稿中导出的。顶部行的归一化被禁用 (False);底部行继承了启用设置 (NotDefined → True)。请保持安装 Arial 以复现此外观。

归一化会在不更改分配的 getFontHeight 值(即以磅为单位的字号)的情况下改变字符高度。段落的 setSpaceWithin 控制行距,而文本框的 setAutofitType 控制文本或其容器的调整方式。这些设置用途不同,可能独立影响整体布局。欲了解更多段落格式和继承,请参阅 Manage Paragraph。
应用和移除删除线
在文本片段上使用 BasePortionFormat.setStrikethroughType 可显示更正、已取消的词语或之前的价格,而无需删除原始文本。将其设置为 TextStrikethroughType.Single or Double 可实现单线或双线删除线。
要移除删除线,请传入 TextStrikethroughType.None_。这会显式禁用该效果,即使周围的格式指定了删除线。相对地,TextStrikethroughType.NotDefined 使本地设置未定义,允许片段继承格式,例如来自段落的设置,但不保证删除线被移除。使用 PortionFormat.getEffective 可读取最终的格式,包括继承值。
下面的独立示例创建了三个价格比较。每段都有标签、原价和现价的独立片段,仅原价受影响。第一行先应用后移除删除线;其余行保留单线和双线删除线。更改此设置可在保留文本及其他格式(例如粗体原价)的同时,实现所需效果。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Paragraph, Portion, Presentation, SaveFormat, ShapeType, TextAlignment, TextStrikethroughType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 620, 220)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getTextFrame().getParagraphs().clear()
labels = ["None: ", "Single: ", "Double: "]
for label in labels:
paragraph = Paragraph()
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left)
paragraph.getParagraphFormat().setSpaceAfter(20)
portion_format = paragraph.getParagraphFormat().getDefaultPortionFormat()
portion_format.setFontHeight(28)
font = FontData("Arial")
portion_format.setLatinFont(font)
portion_format.getFillFormat().setFillType(FillType.Solid)
portion_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
label_portion = Portion(label)
paragraph.getPortions().add(label_portion)
previous_price = Portion("$100")
previous_price.getPortionFormat().setFontBold(NullableBool.True_)
paragraph.getPortions().add(previous_price)
current_price = Portion(" → $80")
paragraph.getPortions().add(current_price)
shape.getTextFrame().getParagraphs().add(paragraph)
paragraphs = shape.getTextFrame().getParagraphs()
# 先应用删除线,然后显式地从第一个原价中移除它。
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Single)
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.None_)
paragraphs.get_Item(1).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Single)
paragraphs.get_Item(2).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Double)
presentation.save("strikethrough.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果(从上到下):无删除线、单线删除线、双线删除线。

设置文本旋转
使用 TextFrameFormat.setTextVerticalType 在形状内设置预定义的文本方向。
下面的代码示例将形状中文本的方向设为 TextVerticalType.Vertical270,即 逆时针旋转 90 度:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextVerticalType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setTextVerticalType(TextVerticalType.Vertical270)
presentation.save("text_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

为文本框设置自定义旋转角度
使用 TextFrameFormat.setRotationAngle 为 TextFrame 设置自定义旋转角度。
下面的代码示例在形状内将文本框顺时针旋转 3 度:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setRotationAngle(3)
presentation.save("custom_text_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

设置段落行距
Aspose.Slides 提供 ParagraphFormat.setSpaceAfter、ParagraphFormat.setSpaceBefore 和 ParagraphFormat.setSpaceWithin 来控制段落间距。这些属性的用法如下:
- 使用正值将行距指定为行高的百分比。
- 使用负值将行距指定为磅数。
下面的示例将第一段的内部间距设为行高的 200%(即双倍行距):
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setSpaceWithin(200)
presentation.save("line_spacing.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

控制换行行为
段落换行规则在窄文本块以及混合拉丁文和东亚文字的演示文稿中非常有用。以下方法属于 ParagraphFormat,因此适用于整个段落:
- setLatinLineBreak 控制拉丁文换行规则。在混合文本中,修改它也会影响相邻的东亚文字和标点的换行位置。
- setEastAsianLineBreak 控制东亚换行规则,包括行首和行尾字符的限制。
这些规则并不取代 TextFrameFormat.setWrapText,后者启用文本框内的自动换行。它们仅在换行发生时影响布局,不会插入换行字符。显式换行符会在段落内部强制另起新行,独立于可用宽度。
下面的独立示例创建一个包含中文和拉丁文的窄文本块。它显式设置两种换行选项并保存为 “line_breaking.pptx”。要实验任一规则,只需更改相应的值并保持另一设置不变。示例使用 24 磅 Arial 与 SimSun,框宽 160 磅,水平文本框边距为零。调用 TextFrameFormat.setAutofitType 并传入 TextAutofitType.None_,使文本大小和框尺寸保持固定。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Presentation, SaveFormat, ShapeType, TextAlignment, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 160, 300)
shape.getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getTextFrameFormat().setWrapText(NullableBool.True_)
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setMarginLeft(0)
text_frame.getTextFrameFormat().setMarginRight(0)
paragraph = text_frame.getParagraphs().get_Item(0)
paragraph.setText("中文排版测试,PowerPoint 中文演示。")
paragraph_format = paragraph.getParagraphFormat()
paragraph_format.setAlignment(TextAlignment.Left)
paragraph_format.getDefaultPortionFormat().setFontHeight(24)
latin_font = FontData("Arial")
paragraph_format.getDefaultPortionFormat().setLatinFont(latin_font)
east_asian_font = FontData("SimSun")
paragraph_format.getDefaultPortionFormat().setEastAsianFont(east_asian_font)
paragraph_format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph_format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
paragraph_format.setLatinLineBreak(NullableBool.False_)
paragraph_format.setEastAsianLineBreak(NullableBool.True_)
presentation.save("line_breaking.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
控制悬挂标点
ParagraphFormat.setHangingPunctuation 允许符合条件的标点超出文本行的右边缘,而不是占据下一行。它作用于整个段落,区别于挂起缩进。
下面的独立示例在宽度为 100 磅的文本框中启用悬挂标点,并保存为 “hanging_punctuation.pptx”。使用 24 磅 Arial 且水平文本框边距为零时,句号仍位于 “sentence” 之后并超出右侧文本边缘。将属性设为 NullableBool.False_ 进行比较:此时句号会占据单独一行。为保持可用宽度固定,启用了换行并禁用了自动适应。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Presentation, SaveFormat, ShapeType, TextAlignment, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 100, 200)
shape.getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getTextFrameFormat().setWrapText(NullableBool.True_)
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setMarginLeft(0)
text_frame.getTextFrameFormat().setMarginRight(0)
paragraph = text_frame.getParagraphs().get_Item(0)
paragraph.setText("Simple text, next sentence.")
paragraph_format = paragraph.getParagraphFormat()
paragraph_format.setAlignment(TextAlignment.Left)
paragraph_format.getDefaultPortionFormat().setFontHeight(24)
latin_font = FontData("Arial")
paragraph_format.getDefaultPortionFormat().setLatinFont(latin_font)
paragraph_format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph_format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
paragraph_format.setHangingPunctuation(NullableBool.True_)
presentation.save("hanging_punctuation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
并非所有标点都能悬挂。上述 字体和布局条件 也适用于此比较:更改字体、可用宽度、边距或自动适应设置都可能消除可见差异。
为文本框设置自动适应类型
TextFrameFormat.setAutofitType 决定当文本超出容器边界时的行为。使用它可以控制文本是缩小、溢出还是自动调整形状大小。以下示例将形状设置为在需要时调整大小以适应文本,并将结果保存为 “autofit_type.pptx”。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextAutofitType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setAutofitType(TextAutofitType.Shape)
presentation.save("autofit_type.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
要在自动换行后计数行数并查看文本或形状宽度的变化,请参阅 Count Rendered Lines。仅统计行数并不能说明文本是否溢出其容器。
设置文本框锚点
TextFrameFormat.setAnchoringType 定义文本在形状内部的垂直定位方式,例如顶部、居中或底部。以下示例将文本锚定在第一个形状的底部,并将结果保存为 “text_anchor.pptx”。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextAnchorType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Bottom)
presentation.save("text_anchor.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
设置文本制表位
使用 ParagraphFormat.setDefaultTabSize 和 ParagraphFormat.getTabs 配置段落中的制表位。下面的示例将默认制表间距设为 100 磅,并在 30 磅处添加左对齐制表位。这些设置会影响包含制表符的文本。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TabAlignment
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setDefaultTabSize(100)
paragraph.getParagraphFormat().getTabs().add(30, TabAlignment.Left)
presentation.save("paragraph_tabs.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
结果:

设置校对语言
Aspose.Slides 提供 BasePortionFormat.setLanguageId,可为文本片段设置校对语言。校对语言决定 PowerPoint 在拼写和语法检查时使用的语言。
下面的示例需要 “presentation.pptx”,其中第一张幻灯片的第一形状是文本框且至少包含一个段落。它将第一段的内容替换为 “1。”,将字体设为 SimSun,并分配简体中文校对语言 (zh-CN)。结果保存为 “proofing_language.pptx”:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, Portion, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getPortions().clear()
font = FontData("SimSun")
text_portion = Portion()
text_portion.getPortionFormat().setComplexScriptFont(font)
text_portion.getPortionFormat().setEastAsianFont(font)
text_portion.getPortionFormat().setLatinFont(font)
# 设置校对语言的 Id。
text_portion.getPortionFormat().setLanguageId("zh-CN")
text_portion.setText("1。")
paragraph.getPortions().add(text_portion)
presentation.save("proofing_language.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
设置默认语言
使用 LoadOptions.setDefaultTextLanguage 定义在加载或创建演示文稿时创建的文本的默认语言。下面的示例创建一个默认文本语言为美式英语的演示文稿,添加一个文本框,并打印其第一个文本片段的语言代码 en-US。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LoadOptions, Presentation, ShapeType
load_options = LoadOptions()
load_options.setDefaultTextLanguage("en-US")
presentation = Presentation(load_options)
try:
slide = presentation.getSlides().get_Item(0)
# 添加一个带文本的矩形形状。
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 50)
shape.getTextFrame().setText("Sample text")
# 检查第一段文本片段的语言。
portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
print(portion.getPortionFormat().getLanguageId())
finally:
presentation.dispose()
设置默认文本样式
要在演示文稿级别应用默认文本格式,请使用 Presentation.getDefaultTextStyle。
下面的示例为新演示文稿中的顶层段落设置 14 磅粗体字体作为默认,并将其保存为 “default_text_style.pptx”。除非更具体的格式覆盖,否则文本会继承这些默认设置。
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import NullableBool, Presentation, SaveFormat
presentation = Presentation()
try:
# 获取顶层段落格式。
paragraph_format = presentation.getDefaultTextStyle().getLevel(0)
if paragraph_format is not None:
paragraph_format.getDefaultPortionFormat().setFontHeight(14)
paragraph_format.getDefaultPortionFormat().setFontBold(NullableBool.True_)
presentation.save("default_text_style.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
提取具有全大写效果的文本
在 PowerPoint 中,应用 All Caps 字体效果会使幻灯片上显示的大写文本,即使原始输入为小写。使用 Aspose.Slides 检索此类文本片段时,库会返回原始输入的文本。要匹配显示的文本,需要检查 TextCapType 并在值为 All 时将返回的字符串转换为大写。
此示例需要 “sample2.pptx”,其中第一张幻灯片的第一形状是文本框。其第一段的第一片段包含 “Hello, Aspose!” 并应用了全大写效果,如下所示。

下面的代码示例展示如何提取带有 All Caps 效果的文本:
import jpime
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, TextCapType
presentation = Presentation("sample2.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
text_portion = auto_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
print("Original text: " + str(text_portion.getText()))
text_format = text_portion.getPortionFormat().getEffective()
if text_format.getTextCapType() == TextCapType.All:
text = str(text_portion.getText()).upper()
print("All-Caps effect: " + text)
finally:
presentation.dispose()
输出:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
FAQ
如何修改幻灯片中表格的文本?
要修改幻灯片中表格的文本,请使用 Table。遍历单元格并通过 Cell.getTextFrame 更新每个单元格,通过 Paragraph.getParagraphFormat 更新段落格式。
如何在 PowerPoint 幻灯片的文本上应用渐变颜色?
要为文本应用渐变颜色,请使用 BasePortionFormat.getFillFormat。将 FillFormat.setFillType 设置为 FillType.Gradient,并配置渐变停靠点、方向和透明度。