在 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();
}
對於符合門檻以下的文字,此設定會阻止字距調整,並有助於使 Aspose.Slides 的渲染與 PowerPoint 在受此 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 或 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 或 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 點且水平文字框邊距為 0。呼叫 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 且水平文字框邊距為 0 時,最後的句點會保留在「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();
}
設定文字定位點 (Tab)
使用 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」,其第一張投影片的第一個圖案為文字方塊。第一段的第一片段包含套用全大寫效果的 “Hello, Aspose!",如下圖所示。

以下程式碼示例說明如何擷取套用 全大寫 效果的文字:
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,並設定漸層停止點、方向與透明度。