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

要查找并突出显示文字字面值或正则表达式匹配项,请参阅 搜索和替换文本。
设置文本背景颜色
使用 ParagraphFormat.getDefaultPortionFormat 来设置段落的默认突出显示颜色,或使用 BasePortionFormat.getHighlightColor 对单个文本片段进行设置。
下面的示例将浅灰色突出显示设置为第一段的默认颜色。对单个片段的显式突出显示颜色将优先于此默认值:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// 为整个段落设置高亮颜色。
paragraph.getParagraphFormat().getDefaultPortionFormat().getHighlightColor().setColor(java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY"));
presentation.save("gray_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

下面的代码示例演示如何为 加粗字体的文本片段 设置背景颜色:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
// 为文本片段设置高亮颜色。
portion.getPortionFormat().getHighlightColor().setColor(java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY"));
}
}
presentation.save("gray_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

对齐文本段落
使用 ParagraphFormat.setAlignment 在文本框内设置段落对齐方式。该值可以是居中、左对齐、右对齐、两端对齐等。
下面的代码示例展示如何将段落对齐到 中心:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// 为段落设置居中对齐。
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Center);
presentation.save("aligned_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

在行内对齐字体
使用 ParagraphFormat.setFontAlignment 在一行内垂直对齐不同字号的文本片段。此设置适用于整个段落,并控制其每行内部的对齐方式。
下面的独立示例在一张幻灯片上创建四个带标签的文本框。每个段落以 18、36 和 54 磅的相同文本显示,并使用不同的字体对齐方式。示例使用 Arial,禁用自动适应和换行,并保持文本框足够大以容纳单行。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const alignments = [aspose.slides.FontAlignment.Baseline, aspose.slides.FontAlignment.Top, aspose.slides.FontAlignment.Center, aspose.slides.FontAlignment.Bottom];
const alignmentNames = ["Baseline", "Top", "Center", "Bottom"];
const fontSizes = [18, 36, 54];
for (let i = 0; i < alignments.length; i++) {
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 20 + i * 130, 660, 120);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
const textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setAnchoringType(java.newByte(aspose.slides.TextAnchorType.Top));
textFrame.getTextFrameFormat().setAutofitType(java.newByte(aspose.slides.TextAutofitType.None));
textFrame.getTextFrameFormat().setWrapText(java.newByte(aspose.slides.NullableBool.False));
const label = textFrame.getParagraphs().get_Item(0);
label.setText(alignmentNames[i]);
label.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
label.getParagraphFormat().getDefaultPortionFormat().setFontHeight(14);
label.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new aspose.slides.FontData("Arial"));
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "GRAY"));
const paragraph = new aspose.slides.Paragraph();
paragraph.getParagraphFormat().setFontAlignment(alignments[i]);
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new aspose.slides.FontData("Arial"));
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
for (const fontSize of fontSizes) {
const portion = new aspose.slides.Portion("Ag ");
portion.getPortionFormat().setFontHeight(fontSize);
paragraph.getPortions().add(portion);
}
textFrame.getParagraphs().add(paragraph);
}
presentation.save("font_alignment.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

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

下面的代码示例展示如何将透明度应用于 加粗字体的文本片段:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const alpha = 50;
const transparentBlack = java.newInstanceSync("java.awt.Color", 0, 0, 0, alpha);
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
const fillFormat = portion.getPortionFormat().getFillFormat();
// 设置文本片段的透明度。
fillFormat.setFillType(java.newByte(aspose.slides.FillType.Solid));
fillFormat.getSolidFillColor().setColor(transparentBlack);
}
}
presentation.save("transparent_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

设置文本字符间距
使用 BasePortionFormat.setSpacing 可在文本框中扩展或收紧字符之间的间距。示例中增加了 3 磅的间距;负值会收紧文本。
下面的 JavaScript 代码展示如何在 整个段落 中扩大字符间距:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// 注意:使用负值来压缩字符间距。
paragraph.getParagraphFormat().getDefaultPortionFormat().setSpacing(3); // 扩展字符间距。
presentation.save("character_spacing_in_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

下面的代码示例展示如何在 加粗字体的文本片段 中扩大字符间距:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
// 注意:使用负值来压缩字符间距。
portion.getPortionFormat().setSpacing(3); // 扩展字符间距。
}
}
presentation.save("character_spacing_in_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

为特定字体禁用字距调整
在某些情况下,Aspose.Slides 渲染的文本可能比 PowerPoint 中显示的相同文本略显紧凑。这可能是因为 PowerPoint 对某些字体会忽略字距调整数据,即使该字体包含有效的字距信息且在 PowerPoint 设置中已启用字距调整。
为使渲染输出更接近 PowerPoint,可对使用受影响字体的文本片段禁用字距调整。将 BasePortionFormat.setKerningMinimalSize 设置为大于实际字号的值。本示例需要一个名为 “presentation.pptx” 的文件,其中第一张幻灯片的第一个形状是文本框。示例检查有效的字体名称(包括继承的字体),并为使用 Roboto 的片段设置 100 磅的阈值。这会对字号低于 100 磅的匹配片段禁用字距调整:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraphs = autoShape.getTextFrame().getParagraphs();
const paragraphCount = paragraphs.getCount();
const targetFont = "Roboto";
for (let paragraphIndex = 0; paragraphIndex < paragraphCount; paragraphIndex++) {
const portions = paragraphs.get_Item(paragraphIndex).getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
const portionFormat = portion.getPortionFormat().getEffective();
const latinFont = portionFormat.getLatinFont();
const eastAsianFont = portionFormat.getEastAsianFont();
const complexScriptFont = portionFormat.getComplexScriptFont();
if ((latinFont !== null && latinFont.getFontName() === targetFont) ||
(eastAsianFont !== null && eastAsianFont.getFontName() === targetFont) ||
(complexScriptFont !== null && complexScriptFont.getFontName() === targetFont)) {
portion.getPortionFormat().setKerningMinimalSize(100);
}
}
}
presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
对于低于阈值的匹配文本,此设置会阻止字距调整,并有助于将受此 PowerPoint 特定行为影响的字体的 Aspose.Slides 渲染结果与 PowerPoint 的视觉输出对齐。
管理文本字体属性
可以通过 ParagraphFormat.getDefaultPortionFormat 在段落级别设置字体属性,或通过 PortionFormat 在单个片段上设置。
下面的示例将第一段的默认字体设置为 12 磅 Times New Roman,并使用粗体、斜体和点线下划线格式。对单个片段的显式格式化将优先于这些默认设置。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const defaultPortionFormat = paragraph.getParagraphFormat().getDefaultPortionFormat();
// 设置段落的字体属性。
defaultPortionFormat.setFontHeight(12);
defaultPortionFormat.setFontBold(java.newByte(aspose.slides.NullableBool.True));
defaultPortionFormat.setFontItalic(java.newByte(aspose.slides.NullableBool.True));
defaultPortionFormat.setFontUnderline(java.newByte(aspose.slides.TextUnderlineType.Dotted));
defaultPortionFormat.setLatinFont(new aspose.slides.FontData("Times New Roman"));
presentation.save("font_properties_for_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

下面的示例对有效格式为粗体的片段应用 13 磅 Times New Roman、斜体和点线下划线:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
const portionFormat = portion.getPortionFormat();
// 为文本片段设置字体属性。
portionFormat.setFontHeight(13);
portionFormat.setFontItalic(java.newByte(aspose.slides.NullableBool.True));
portionFormat.setFontUnderline(java.newByte(aspose.slides.TextUnderlineType.Dotted));
portionFormat.setLatinFont(new aspose.slides.FontData("Times New Roman"));
}
}
presentation.save("font_properties_for_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

控制文本高度归一化
在复现模板排版或调查字符高度差异时,请使用 BasePortionFormat.setNormaliseHeight。在 PowerPoint 中,启用归一化会垂直拉伸或压缩各个字符,使它们在文本片段内具有统一的可视高度。但这并不保证不同字体的文本高度相等。
将属性设置为 NullableBool.True or False 可显式启用或禁用归一化。NullableBool.NotDefined 表示本地设置未定义,从而使片段继承其值,例如来自段落的 getDefaultPortionFormat。这并不等同于 False。使用 PortionFormat.getEffective 并读取 IBasePortionFormatEffectiveData.getNormaliseHeight 可获得解析后的布尔值。
下面的独立示例需要安装 Arial。它创建两个文本块,分别包含相同的大写字母、小写字母、下行字和重音字符,字号为 54 磅。两个段落默认启用归一化。顶部片段显式禁用;底部片段继承该设置。框架尺寸、边距和段落间距相同,且禁用了换行和自动适应,以保持比较的一致性。示例输出 False: false 和 NotDefined: true,随后保存为 “text_height_normalization.pptx”。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const settings = [aspose.slides.NullableBool.False, aspose.slides.NullableBool.NotDefined];
const settingNames = ["False", "NotDefined"];
for (let i = 0; i < settings.length; i++) {
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 60 + i * 200, 660, 150);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
const textFrame = shape.getTextFrame();
textFrame.setText("Hxgjpq ÅÉ 0123");
textFrame.getTextFrameFormat().setAutofitType(java.newByte(aspose.slides.TextAutofitType.None));
textFrame.getTextFrameFormat().setWrapText(java.newByte(aspose.slides.NullableBool.False));
textFrame.getTextFrameFormat().setAnchoringType(java.newByte(aspose.slides.TextAnchorType.Top));
textFrame.getTextFrameFormat().setMarginTop(0);
textFrame.getTextFrameFormat().setMarginLeft(0);
const paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceBefore(0);
paragraph.getParagraphFormat().setSpaceAfter(0);
paragraph.getParagraphFormat().setSpaceWithin(100);
paragraph.getParagraphFormat().getDefaultPortionFormat().setNormaliseHeight(java.newByte(aspose.slides.NullableBool.True));
const portion = paragraph.getPortions().get_Item(0);
const font = new aspose.slides.FontData("Arial");
portion.getPortionFormat().setLatinFont(font);
portion.getPortionFormat().setFontHeight(54);
portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
const textColor = java.getStaticFieldValue("java.awt.Color", "BLACK");
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(textColor);
portion.getPortionFormat().setNormaliseHeight(java.newByte(settings[i]));
console.log(settingNames[i] + ": " + portion.getPortionFormat().getEffective().getNormaliseHeight());
}
presentation.save("text_height_normalization.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
下面的比较图是从已保存的演示文稿导出的。顶部行的归一化已禁用(False);底部行继承了已启用的设置(NotDefined → True)。请保持安装 Arial 以重现此外观。

归一化会改变字符高度,但不会改变分配的 getFontHeight 值,该值指定字体大小(磅)。段落的 setSpaceWithin 控制行距,而文本框的 setAutofitType 控制文本或其容器的适配方式。这些设置各自作用不同,可能独立影响整体布局。有关段落格式化和继承的更多信息,请参阅 管理段落。
应用和移除删除线
在文本片段上使用 BasePortionFormat.setStrikethroughType 可显示更正、已取消的词语或以前的价格,而不删除原始文本。将其设置为 TextStrikethroughType.Single or Double 可在文本上加一条或两条删除线。
要移除删除线,请传入 TextStrikethroughType.None。这会显式禁用该效果,即使周围的格式指定了删除线。相比之下,TextStrikethroughType.NotDefined 将本地设置保持未定义,从而使片段继承格式,例如来自段落的设置。它并不保证删除线被移除。使用 PortionFormat.getEffective 可读取结果格式,包括继承的值。
下面的独立示例创建了三个价格比较。每个段落都有标签、原价和现价的独立片段,因此仅原价受影响。第一行先应用后移除删除线;其余行保留单线和双线删除线。更改此设置可保留文本及其其他格式,包括粗体的原价。
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 620, 220);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getTextFrame().getParagraphs().clear();
const labels = ["None: ", "Single: ", "Double: "];
for (const label of labels) {
const paragraph = new aspose.slides.Paragraph();
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceAfter(20);
const format = paragraph.getParagraphFormat().getDefaultPortionFormat();
format.setFontHeight(28);
const font = new aspose.slides.FontData("Arial");
format.setLatinFont(font);
format.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
const textColor = java.getStaticFieldValue("java.awt.Color", "BLACK");
format.getFillFormat().getSolidFillColor().setColor(textColor);
const labelPortion = new aspose.slides.Portion(label);
paragraph.getPortions().add(labelPortion);
const previousPrice = new aspose.slides.Portion("$100");
previousPrice.getPortionFormat().setFontBold(java.newByte(aspose.slides.NullableBool.True));
paragraph.getPortions().add(previousPrice);
const currentPrice = new aspose.slides.Portion(" → $80");
paragraph.getPortions().add(currentPrice);
shape.getTextFrame().getParagraphs().add(paragraph);
}
const paragraphs = shape.getTextFrame().getParagraphs();
// 先应用删除线,然后显式地移除第一条原价的删除线。
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.Single));
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.None));
paragraphs.get_Item(1).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.Single));
paragraphs.get_Item(2).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.Double));
presentation.save("strikethrough.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果(从上到下):无删除线、单线删除线和双线删除线。

设置文本旋转
使用 TextFrameFormat.setTextVerticalType 可在形状内设置预定义的文本方向。
下面的代码示例将形状中的文本方向设置为 TextVerticalType.Vertical270,它将文本 逆时针旋转 90 度:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setTextVerticalType(java.newByte(aspose.slides.TextVerticalType.Vertical270));
presentation.save("text_rotation.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

为文本框设置自定义旋转
使用 TextFrameFormat.setRotationAngle 可以为 TextFrame 设置自定义旋转角度。
下面的代码示例在形状内将文本框顺时针旋转 3 度:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setRotationAngle(3);
presentation.save("custom_text_rotation.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

设置段落行距
Aspose.Slides 提供 ParagraphFormat.setSpaceAfter、ParagraphFormat.setSpaceBefore 和 ParagraphFormat.setSpaceWithin 来控制段落间距。使用方式如下:
- 使用正值将行距指定为行高的百分比。
- 使用负值将行距指定为磅值。
下面的示例将第一段内部的间距设置为行高的 200%(双倍行距):
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setSpaceWithin(200);
presentation.save("line_spacing.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
结果:

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

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

下面的代码示例展示如何提取带有 All Caps 效果的文本:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample2.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const textPortion = autoShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
console.log("Original text: " + textPortion.getText());
const textFormat = textPortion.getPortionFormat().getEffective();
if (textFormat.getTextCapType() === aspose.slides.TextCapType.All) {
const text = textPortion.getText().toUpperCase();
console.log("All-Caps effect: " + text);
}
} finally {
presentation.dispose();
}
输出:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
常见问题
如何在幻灯片上的表格中修改文本?
要在幻灯片的表格中修改文本,请使用 Table。遍历单元格,并通过 Cell.getTextFrame 更新每个单元格,通过 Paragraph.getParagraphFormat 更新段落格式。
如何在 PowerPoint 幻灯片上的文本应用渐变颜色?
要为文本应用渐变颜色,请使用 BasePortionFormat.getFillFormat。将 FillFormat.setFillType 设置为 FillType.Gradient,并配置渐变止点、方向和透明度。