在 JavaScript 中將數學方程式加入 PowerPoint 簡報
概述
PowerPoint 將方程式儲存為 Office Math Markup Language(OMML)。使用 Aspose.Slides for Node.js via Java,您可以以程式化方式建立相同類型的數學內容:分數、根號、函數、極限、N 元運算子、矩陣、陣列,以及格式化的數學區塊。
在 PowerPoint 中,使用者通常從 插入 > 方程式 加入方程式:

結果是在投影片上可編輯的數學文字:

Aspose.Slides 透過三個主要物件建立該數學文字:
- 數學形狀,使用 addMathShape 建立,為包含方程式的形狀。
- MathPortion 將數學內容儲存在形狀的文字框內。
- MathParagraph 包含一個或多個 MathBlock 物件。
以下大多數範例使用 MathematicalText 以及 MathElementBase 的流暢方法,以保持程式碼簡短且易讀。
若需 MathML 匯出情境,請參閱 從 Node.js via Java 匯出簡報中的數學方程式。
建立方程式
此範例使用 addMathShape 建立數學形狀,並加入畢氏定理:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 120);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let equation = new aspose.slides.MathematicalText("c")
.setSuperscript("2")
.join("=")
.join(new aspose.slides.MathematicalText("a").setSuperscript("2"))
.join("+")
.join(new aspose.slides.MathematicalText("b").setSuperscript("2"));
mathParagraph.add(equation);
presentation.save("pythagorean-theorem.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
組合數學區塊
當方程式的部份以 MathBlock 物件獨立建立時,請使用 joinBlock 進行合併。此範例在左側區塊建立 c² =,右側區塊建立 a² + b²。setSuperscript 為所有三個次方建立可編輯的數學上標。
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const shape = slide.getShapes().addMathShape(20, 20, 600, 100);
const mathPortion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
const mathParagraph = mathPortion.getMathParagraph();
const leftBlock = new slides.MathBlock();
leftBlock.add(new slides.MathematicalText("c").setSuperscript("2"));
leftBlock.add(new slides.MathematicalText("="));
const rightBlock = new slides.MathBlock();
rightBlock.add(new slides.MathematicalText("a").setSuperscript("2"));
rightBlock.add(new slides.MathematicalText("+"));
rightBlock.add(new slides.MathematicalText("b").setSuperscript("2"));
const combinedBlock = leftBlock.joinBlock(rightBlock);
mathParagraph.add(combinedBlock);
presentation.save("equation.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
joinBlock 返回 leftBlock 本身,現在依序包含兩個部份,且 rightBlock 為空。僅將合併後的區塊一次加入 MathParagraph。重新開啟 equation.pptx 後,段落只包含一個區塊,呈現 c² = a² + b²,且三個次方皆保留為數學上標。
若以 leftBlock.add(rightBlock) 呼叫 add,會嘗試直接將一個區塊嵌入另一個區塊,並拋出 InvalidOperationException。
加入分數
使用 divide 建立分數。您可以使用 MathFractionTypes 選擇分數樣式。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let fraction = new aspose.slides.MathematicalText("1")
.divide("x", aspose.slides.MathFractionTypes.Skewed);
mathParagraph.add(new aspose.slides.MathBlock(fraction));
presentation.save("fraction.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
欲使用堆疊式分數,請使用 MathFractionTypes.Bar:
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let stackedFraction = new aspose.slides.MathematicalText("x + 1").divide("y - 1", aspose.slides.MathFractionTypes.Bar);
加入根號
使用 radical 建立平方根、立方根或其他根。當前元素成為底部,參數則成為指數。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let radical = new aspose.slides.MathematicalText("x")
.radical("n");
mathParagraph.add(new aspose.slides.MathBlock(radical));
presentation.save("radical.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
顯示或隱藏平方根的指數
平方根可以顯示明確的 2,或使用慣用的 √x 記法。MathRadical 的 setHideDegree 方法控制顯示哪種形式。兩種形式皆保留指數 2 及根號內的 x,且在可編輯的方程式中保持不變。

此範例將相同的平方根儲存兩次。於 visible-degree.pptx 中 2 可見;於 hidden-degree.pptx 中 2 隱藏。
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let radical = new aspose.slides.MathematicalText("x").radical("2");
let shape = slide.getShapes().addMathShape(20, 20, 200, 100);
let portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
portion.getMathParagraph().add(new aspose.slides.MathBlock(radical));
radical.setHideDegree(false);
presentation.save("visible-degree.pptx", aspose.slides.SaveFormat.Pptx);
radical.setHideDegree(true);
presentation.save("hidden-degree.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
加入函數與極限
使用 asArgumentOfFunction 或 function 來建立函數,例如 sin(x)、log(x),或自訂函數名稱。對於極限,將 lim 放入 MathLimit 中,或使用 setLowerLimit。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let limit = new aspose.slides.MathematicalText("lim")
.setLowerLimit("x\u2192\u221E")
.function("x");
mathParagraph.add(new aspose.slides.MathBlock(limit));
presentation.save("functions-and-limits.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
若使用自訂函數名稱,將函數名稱設為當前元素,並以其參數呼叫 function:
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let customFunction = new aspose.slides.MathematicalText("f").function("x + 1");
加入 N 元運算子與積分
使用 nary 用於求和、聯集、交集與其他大型運算子。使用 integral 用於積分。兩種方法皆可設定上下限。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 120);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let summationBase = new aspose.slides.MathematicalText("x")
.setSuperscript("k")
.join(new aspose.slides.MathematicalText("a").setSuperscript("n-k"));
let summation = summationBase.nary(aspose.slides.MathNaryOperatorTypes.Summation, "k=0", "n");
mathParagraph.add(new aspose.slides.MathBlock(summation));
presentation.save("nary-operators.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
N 元運算子用於帶有可選上下限的大型運算子。諸如 +、-、= 等簡單運算子通常以 MathematicalText 加入並結合成表達式。
若要建立積分,使用 integral:
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let integralBase = new aspose.slides.MathematicalText("x").join(new aspose.slides.MathematicalText("dx").toBox());
let integral = integralBase.integral(aspose.slides.MathIntegralTypes.Simple, "0", "1");
加入矩陣
使用 MathMatrix 建立列與行。矩陣預設不包含括號,如需括號、方括號或大括號,請自行將矩陣包起來。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 120);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let matrix = new aspose.slides.MathMatrix(2, 3);
matrix.set_Item(0, 0, new aspose.slides.MathematicalText("1"));
matrix.set_Item(0, 1, new aspose.slides.MathematicalText("x"));
matrix.set_Item(1, 0, new aspose.slides.MathematicalText("x"));
matrix.set_Item(1, 1, new aspose.slides.MathematicalText("2"));
matrix.set_Item(1, 2, new aspose.slides.MathematicalText("y"));
mathParagraph.add(new aspose.slides.MathBlock(matrix));
presentation.save("matrix.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
編輯現有矩陣
假設線性代數課程以 matrix.pptx 中的係數矩陣開始,此檔案由前面的範例儲存。下一個練習保留第一個方程式,將第二個替換為兩個新方程式,並重新設定變數。透過 MathMatrix 開啟現有矩陣,以保留仍然適用的係數。

列與欄索引從 0 起算,且每次呼叫時皆以當前矩陣狀態為基礎。於索引 1 之前插入列會將原本的第二列移至索引 2。於索引 2 之後插入則在最後附加一列。刪除索引 2 的列會移除原本的第二個方程式,並將附加的列向上移動一個位置。欄的移動方式相同。
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("matrix.pptx");
try {
const shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
const portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
const matrix = portion.getMathParagraph().get_Item(0).get_Item(0);
matrix.insertRowBefore(1);
matrix.insertRowAfter(2);
matrix.deleteRow(2);
matrix.insertColumnBefore(1);
matrix.insertColumnAfter(3);
matrix.deleteColumn(3);
// 新儲存格最初為 null。先設定非零係數。
matrix.set_Item(1, 0, new slides.MathematicalText("12"));
matrix.set_Item(1, 1, new slides.MathematicalText("1"));
matrix.set_Item(2, 2, new slides.MathematicalText("10"));
matrix.set_Item(2, 3, new slides.MathematicalText("1"));
for (let row = 0; row < matrix.getRowCount(); row++) {
for (let column = 0; column < matrix.getColumnCount(); column++) {
if (matrix.get_Item(row, column) == null) {
matrix.set_Item(row, column, new slides.MathematicalText("0"));
}
}
}
matrix.setColumnAlignment(0, slides.MathHorizontalAlignment.Left);
matrix.setColumnsAlignment(1, 3, slides.MathHorizontalAlignment.Right);
presentation.save("updated-matrix.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
setColumnAlignment 將第一欄左對齊。setColumnsAlignment 由索引 1 起將連續三欄右對齊。在 updated-matrix.pptx 中,矩陣包含三個方程式與四個變數。原本第一列的係數 1 與 x 現在出現在第一與第三欄。

加入方程式陣列
使用 toMathArray 於需要對齊方程式或垂直堆疊表達式時。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 140);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let equationArray = new aspose.slides.MathematicalText("x")
.join("y")
.toMathArray();
mathParagraph.add(new aspose.slides.MathBlock(equationArray));
presentation.save("equation-array.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
將陣列與周圍元素對齊
setBaseJustification 控制陣列相對於旁邊數學元素的垂直對齊。下例比較第一列、陣列中心與最後一列的對齊方式。
以下範例建立三個相同的陣列,每個陣列都有三列,旁邊的元素分別為 A= 與 =B。所有數學文字均使用 Cambria Math,字型大小 24 點。唯一改變的是陣列的對齊方式。
const slides = require("aspose.slides.via.java");
const java = require("java");
function createText(value) {
const text = new slides.MathematicalText(value);
text.getFormat().setFontHeight(24);
text.getFormat().setLatinFont(new slides.FontData("Cambria Math"));
return text;
}
const presentation = new slides.Presentation();
try {
presentation.getSlideSize().setSize(780, 200, slides.SlideSizeScaleType.DoNotScale);
const slide = presentation.getSlides().get_Item(0);
const alignments = [slides.MathVerticalAlignment.Top, slides.MathVerticalAlignment.Center, slides.MathVerticalAlignment.Bottom];
const alignmentNames = ["Top", "Center", "Bottom"];
for (let i = 0; i < alignments.length; i++) {
const label = slide.getShapes().addAutoShape(slides.ShapeType.Rectangle, 20 + i * 260, 10, 240, 30);
label.getFillFormat().setFillType(java.newByte(slides.FillType.NoFill));
label.getLineFormat().getFillFormat().setFillType(java.newByte(slides.FillType.NoFill));
label.getTextFrame().setText(alignmentNames[i]);
const labelFormat = label.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
labelFormat.setFontHeight(16);
labelFormat.getFillFormat().setFillType(java.newByte(slides.FillType.Solid));
labelFormat.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
const mathShape = slide.getShapes().addMathShape(20 + i * 260, 60, 240, 130);
mathShape.getTextFrame().getTextFrameFormat().setAnchoringType(java.newByte(slides.TextAnchorType.Top));
const mathParagraph = mathShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph();
mathParagraph.setJustification(slides.MathJustification.LeftJustified);
const rows = [createText("x+y=3"), createText("x-y=1"), createText("x=2")];
const equationArray = new slides.MathArray(rows[0]);
equationArray.getArguments().add(rows[1]);
equationArray.getArguments().add(rows[2]);
equationArray.setBaseJustification(alignments[i]);
const leftText = createText("A=");
const rightText = createText("=B");
const equation = new slides.MathBlock(leftText).join(equationArray).join(rightText);
mathParagraph.add(equation);
}
presentation.save("equation-array-alignment.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
以下比較圖示說明在 PowerPoint 中儲存的簡報。請注意每個陣列旁側的 A= 與 =B 位置。

設定列間距
setRowSpacingRule 選擇陣列內列的間距規則。setRowSpacing 提供數值以指定明確的間距規則,預設規則會忽略此數值。
若需精確間距,數值以 point 為單位。若需比例間距,則以半行為單位:範例中的 3 代表 1.5 行。若要指定明確數值,需同時設定兩個屬性;僅變更數值本身不會自動選擇間距規則。
下例儲存了五個簡報,所有方程式、對齊與字型設定相同。前三個使用預設規則,最後兩個顯示明確數值。
const slides = require("aspose.slides.via.java");
const java = require("java");
function createText(value) {
const text = new slides.MathematicalText(value);
text.getFormat().setFontHeight(24);
text.getFormat().setLatinFont(new slides.FontData("Cambria Math"));
return text;
}
const rules = [slides.MathRowSpacingRule.SingleLineGap, slides.MathRowSpacingRule.OneAndAHalfLineGap, slides.MathRowSpacingRule.TwoLineGap, slides.MathRowSpacingRule.Exactly, slides.MathRowSpacingRule.Multiple];
const spacingValues = [0, 0, 0, 20, 3];
const ruleNames = ["SingleLineGap", "OneAndAHalfLineGap", "TwoLineGap", "Exactly", "Multiple"];
for (let i = 0; i < rules.length; i++) {
const fileName = "equation-array-" + ruleNames[i] + ".pptx";
const presentation = new slides.Presentation();
try {
const mathShape = presentation.getSlides().get_Item(0).getShapes().addMathShape(20, 20, 600, 300);
const paragraph = mathShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setSpaceBefore(0);
paragraph.getParagraphFormat().setSpaceAfter(0);
const mathParagraph = paragraph.getPortions().get_Item(0).getMathParagraph();
mathParagraph.setJustification(slides.MathJustification.LeftJustified);
const rows = [createText("x+y=3"), createText("x-y=1"), createText("x=2")];
const equationArray = new slides.MathArray(rows[0]);
equationArray.getArguments().add(rows[1]);
equationArray.getArguments().add(rows[2]);
equationArray.setBaseJustification(slides.MathVerticalAlignment.Center);
equationArray.setRowSpacingRule(rules[i]);
equationArray.setRowSpacing(java.newLong(spacingValues[i]));
const leftText = createText("A=");
const rightText = createText("=B");
const equation = new slides.MathBlock(leftText).join(equationArray).join(rightText);
mathParagraph.add(equation);
presentation.save(fileName, slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
}
陣列的列間距獨立於段落間距。setSpaceBefore 與 setSpaceAfter 會在包含段落的前後加入空間,而不會影響陣列列之間的距離。同理,MathParagraph.setJustification 只會水平定位整個數學段落,並不會取代陣列的垂直對齊設定。
加入三角函數
使用 asArgumentOfFunction 當參數為當前元素且函數名稱已知。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let cosine = new aspose.slides.MathematicalText("2x")
.asArgumentOfFunction(aspose.slides.MathFunctionsOfOneArgument.Cos);
mathParagraph.add(new aspose.slides.MathBlock(cosine));
presentation.save("trigonometric-function.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
加入下標與上標
使用下標與上標輔助方法處理指標與次方。若指標必須出現在基底的左側,請使用 setSubSuperscriptOnTheLeft。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let scripts = new aspose.slides.MathematicalText("Y")
.setSubSuperscriptOnTheLeft("1", "n");
mathParagraph.add(new aspose.slides.MathBlock(scripts));
presentation.save("subscript-superscript.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
對齊右側下標與上標
當兩個標記屬於同一基底時,請使用 MathRightSubSuperscriptElement。其 setAlignScripts 方法控制水平位置:false(預設值)讓它們遵循基底輪廓,而 true 則使兩個標記水平對齊。
此範例將相同的可編輯表達式放置兩個副本並排。兩者皆使用數學斜體 f(U+1D453),下標 1,上標 2,字型為 Cambria Math,大小 72 點。傾斜的基底使差異在 PowerPoint 中明顯可見。執行範例前請先安裝 Cambria Math。
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
presentation.getSlideSize().setSize(900, 250, slides.SlideSizeScaleType.DoNotScale);
const slide = presentation.getSlides().get_Item(0);
const format = new slides.PortionFormat();
format.setFontHeight(72);
const font = new slides.FontData("Cambria Math");
format.setLatinFont(font);
for (let i = 0; i < 2; i++) {
const left = 40 + i * 440;
const shape = slide.getShapes().addMathShape(left, 75, 380, 150);
const baseText = new slides.MathematicalText("\uD835\uDC53", format);
const subscript = new slides.MathematicalText("1", format);
const superscript = new slides.MathematicalText("2", format);
const scripts = new slides.MathRightSubSuperscriptElement(baseText, subscript, superscript);
scripts.setAlignScripts(i === 1);
const portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
portion.getPortionFormat().setFontHeight(format.getFontHeight());
portion.getPortionFormat().setLatinFont(format.getLatinFont());
const block = new slides.MathBlock(scripts);
portion.getMathParagraph().add(block);
}
presentation.save("aligned-scripts.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}

左側的下標起始位置較左,較上標更靠左,遵循基底輪廓。右側的兩個標記則水平對齊。
加入分隔符
使用 enclose 可將表達式包在分隔符之中。對於包含多個元素的分隔符表達式,亦可設定分隔字元。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let delimiter = new aspose.slides.MathematicalText("x")
.join("y")
.join("z")
.enclose(java.newChar('<'), java.newChar('>'));
delimiter.setSeparatorCharacter(java.newChar('|'));
mathParagraph.add(new aspose.slides.MathBlock(delimiter));
presentation.save("delimiters.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
調整分隔符的大小與對齊
傳入 true 給 setGrowToMatchOperandHeight 可讓括號依據較高的運算元自動放大,傳入 false 則保持正常大小。使用 setDelimiterShape 並搭配其中一個 MathDelimiterShape 值。Centered 使括號以等號中線為基準置中;Match 使括號與內部內容對齊。兩種設定僅影響分隔符,內部的表達式保持不變。
此範例將分數放於 x 的指數位置,使表達式在基線上方的伸展度較下方更大。四個方程式皆使用相同的括號與字型設定。
const slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
for (let row = 0; row < 2; row++) {
for (let column = 0; column < 2; column++) {
const fraction = new slides.MathematicalText("a + b").divide("c + d");
const power = new slides.MathematicalText("x").setSuperscript(fraction);
const delimiter = power.enclose(java.newChar('('), java.newChar(')'));
delimiter.setGrowToMatchOperandHeight(row === 0);
delimiter.setDelimiterShape(column === 0 ? slides.MathDelimiterShape.Centered : slides.MathDelimiterShape.Match);
const mathShape = slide.getShapes().addMathShape(20 + 330 * column, 20 + 120 * row, 300, 100);
const portion = mathShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
portion.getPortionFormat().setFontHeight(32);
const equation = new slides.MathematicalText("y = ").join(delimiter);
portion.getMathParagraph().add(equation);
}
}
presentation.save("delimiter-sizing.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
在 PowerPoint 中比較各列即可看到增長的效果。上列的括號會因指數而自動放大,兩種形狀看起來相同。下列則關閉增長。左側較小的括號(Centered)與等號對齊,而右側(Match)則在表達式上方稍高。

加入框線盒
呼叫 toBorderBox 於分數上,可為整個表達式加框。預設會以 MathBorderBox 顯示四條邊。使用 setHideTop、setHideBottom、setHideLeft 與 setHideRight 可移除單獨的邊。
此範例在同一投影片上放置六個相同的分數。為顯示抵消效果,隱藏全部四條邊,並傳入 true 給 setStrikethroughBottomLeftToTopRight 產生上升對角線(↗),或傳入 true 給 setStrikethroughTopLeftToBottomRight 產生下降對角線(↘)。亦可搭配 setStrikethroughHorizontal 或 setStrikethroughVertical,自行組合各可見邊。
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
presentation.getSlideSize().setSize(540, 220, slides.SlideSizeScaleType.DoNotScale);
const slide = presentation.getSlides().get_Item(0);
function addFraction(x, y, hideBorder) {
const fraction = new slides.MathematicalText("x+1").divide("y+2");
const box = fraction.toBorderBox();
box.setHideTop(hideBorder);
box.setHideBottom(hideBorder);
box.setHideLeft(hideBorder);
box.setHideRight(hideBorder);
const shape = slide.getShapes().addMathShape(x, y, 160, 90);
const portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
portion.getPortionFormat().setFontHeight(28);
const block = new slides.MathBlock(box);
portion.getMathParagraph().add(block);
return box;
}
addFraction(10, 10, false);
const partial = addFraction(190, 10, false);
partial.setHideTop(true);
partial.setHideRight(true);
addFraction(370, 10, true).setStrikethroughBottomLeftToTopRight(true);
addFraction(10, 120, true).setStrikethroughTopLeftToBottomRight(true);
addFraction(190, 120, true).setStrikethroughHorizontal(true);
addFraction(370, 120, false).setStrikethroughVertical(true);
presentation.save("border-box.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}

在此分數中,水平刪除線與分數線重疊。垂直刪除線穿過分子與分母,同時保留外圍框線可見。這些線條裝飾整個表達式。普通文字的刪除線僅套用於文字執行序中的字元。重新在 PowerPoint 開啟簡報後,仍可分別編輯分子與分母。
使用幻影元素控制可見性與版面配置
將表達式包在 MathPhantom 中,可獨立控制其可見性以及在方程式中佔用的空間。MathPhantom 方法可控制下列項目:
| 方法 | 效果 |
|---|---|
| setShow | 傳入 false 隱藏表達式。其尺寸仍會計入版面配置,除非下面對應的方法傳入 true。 |
| setZeroWidth | 將表達式的水平寬度視為 0,允許相鄰元素更靠近。 |
| setZeroAsc | 將其上升部(基線上方的高度)視為 0,可減少相鄰元素上方保留的空間。 |
| setZeroDesc | 將其下降部(基線下方的深度)視為 0,可使分數線或其他內容更靠近下方的相鄰元素。 |
基線是普通數學字母所坐落的參考線。隱藏內容不會移除其尺寸,將尺寸視為零亦不會刪除表達式。底層表達式仍可透過 getBase 取得。傳入 true 給 setShow 可再次顯示,它的尺寸設定保持不變。
下例建立五個並排變體:一個可見分數、一個保留空間的隱藏分數,以及三個分別將寬度、上升或下降視為零的隱藏分數。每個變體使用相同的周圍表達式與 Cambria Math(24 點)。所有方程式形狀的上部位置相同,以灰色參考線標示。將幻影放在外部分數的分子中,可更容易觀察垂直版面變化。
const slides = require("aspose.slides.via.java");
const java = require("java");
function createText(value) {
const text = new slides.MathematicalText(value);
text.getFormat().setFontHeight(24);
text.getFormat().setLatinFont(new slides.FontData("Cambria Math"));
return text;
}
const presentation = new slides.Presentation();
try {
presentation.getSlideSize().setSize(1000, 180, slides.SlideSizeScaleType.DoNotScale);
const slide = presentation.getSlides().get_Item(0);
const labels = [ "Visible", "Hidden: reserves space", "Hidden: ZeroWidth", "Hidden: ZeroAsc", "Hidden: ZeroDesc" ];
const guide = slide.getShapes().addAutoShape(slides.ShapeType.Line, 10, 60, 980, 0);
guide.getLineFormat().getFillFormat().setFillType(java.newByte(slides.FillType.Solid));
guide.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY"));
for (let i = 0; i < labels.length; i++) {
const left = 10 + i * 200;
const label = slide.getShapes().addAutoShape(slides.ShapeType.Rectangle, left, 10, 190, 30);
label.getFillFormat().setFillType(java.newByte(slides.FillType.NoFill));
label.getLineFormat().getFillFormat().setFillType(java.newByte(slides.FillType.NoFill));
label.getTextFrame().setText(labels[i]);
const labelFormat = label.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
labelFormat.setFontHeight(14);
labelFormat.getFillFormat().setFillType(java.newByte(slides.FillType.Solid));
labelFormat.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
const fractionNumerator = createText("a+b");
const fractionDenominator = createText("c+d");
const fraction = new slides.MathFraction(fractionNumerator, fractionDenominator);
const phantom = new slides.MathPhantom(fraction);
phantom.setShow(i === 0);
phantom.setZeroWidth(i === 2);
phantom.setZeroAsc(i === 3);
phantom.setZeroDesc(i === 4);
const leftText = createText("x+");
const rightText = createText("+y");
const numerator = new slides.MathBlock(leftText).join(phantom).join(rightText);
const denominator = createText("z");
const equation = new slides.MathFraction(numerator, denominator);
const shape = slide.getShapes().addMathShape(left, 60, 190, 100);
shape.getTextFrame().getTextFrameFormat().setAnchoringType(java.newByte(slides.TextAnchorType.Top));
const mathPortion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
const mathParagraph = mathPortion.getMathParagraph();
mathParagraph.add(new slides.MathBlock(equation));
}
presentation.save("math-phantom.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}

分組項目
使用 group 可將分組符號放置於表達式之上或之下。再加入極限以為分組項目加上標籤。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 120);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let grouped = new aspose.slides.MathematicalText("x + y")
.group(java.newChar('\u23DF'), aspose.slides.MathTopBotPositions.Bottom, aspose.slides.MathTopBotPositions.Top)
.setLowerLimit("any text");
mathParagraph.add(new aspose.slides.MathBlock(grouped));
presentation.save("grouped-terms.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
格式化數學元素
僅在能夠使公式更清晰時才使用格式化輔助方法。例如,overbar 可在數學元素上方加上一條橫線。

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
let presentation = new aspose.slides.Presentation();
try {
let slide = presentation.getSlides().get_Item(0);
let mathShape = slide.getShapes().addMathShape(20, 20, 700, 100);
let mathParagraph = mathShape.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getMathParagraph();
let overbar = new aspose.slides.MathematicalText("ABC").overbar();
mathParagraph.add(new aspose.slides.MathBlock(overbar));
presentation.save("overbar.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
在現有方程式中格式化文字
若要在整個現有方程式中格式化文字,需遍歷每個數學區塊的元素樹。MathElementBase.getChildren 只回傳直接子項,必須遞迴呼叫才能取得分數、標記、根號以及其他巢狀結構內的文字。檢查當前元素與其子項,以在元素本身為 MathematicalText 時亦能包含在內。
此範例假設 input.pptx 包含如 z = xᵢ / ∛y 的方程式,其中分數的分子含有下標,分母含有根號。僅處理區塊的最高層元素會遺漏分數內的文字。範例在投影片文字框中尋找數學部分,透過 MathPortion.getMathParagraph 取得其區塊,並使用 setFontHeight 透過每個文字元素的 getFormat 方法將字型大小設定為 28 點。
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
function formatMathText(element) {
if (java.instanceOf(element, "com.aspose.slides.MathematicalText")) {
element.getFormat().setFontHeight(28);
}
let children = element.getChildren();
for (let i = 0; i < children.length; i++) {
formatMathText(children[i]);
}
}
let presentation = new aspose.slides.Presentation("input.pptx");
try {
for (let i = 0; i < presentation.getSlides().size(); i++) {
let slide = presentation.getSlides().get_Item(i);
for (let j = 0; j < slide.getShapes().size(); j++) {
let shape = slide.getShapes().get_Item(j);
if (!java.instanceOf(shape, "com.aspose.slides.IAutoShape")) {
continue;
}
let textFrame = shape.getTextFrame();
if (textFrame == null) {
continue;
}
for (let k = 0; k < textFrame.getParagraphs().getCount(); k++) {
let paragraph = textFrame.getParagraphs().get_Item(k);
for (let l = 0; l < paragraph.getPortions().getCount(); l++) {
let portion = paragraph.getPortions().get_Item(l);
if (java.instanceOf(portion, "com.aspose.slides.IMathPortion")) {
let mathParagraph = portion.getMathParagraph();
for (let m = 0; m < mathParagraph.getCount(); m++) {
formatMathText(mathParagraph.get_Item(m));
}
}
}
}
}
}
presentation.save("formatted-equations.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
儲存的簡報在每個已處理方程式的各層級皆包含更新後的文字格式,同時保留原始文字內容與數學結構。
快速參考
| 任務 | 主要 API |
|---|---|
| 建立數學文字 | MathematicalText |
| 組合元素 | join |
| 建立分數 | divide |
| 加入上標或下標 | setSuperscript, setSubscript |
| 加入函數 | function, asArgumentOfFunction |
| 加入根號 | radical |
| 加入極限 | setLowerLimit, setUpperLimit |
| 加入左側標記 | setSubSuperscriptOnTheLeft |
| 加入求和與積分 | nary, integral |
| 加入矩陣 | MathMatrix |
| 加入方程式陣列 | toMathArray |
| 加入分隔符 | enclose |
| 加入條與框線 | overbar, toBorderBox |
| 分組項目 | group |
常見問題
我可以編輯現有的 PowerPoint 方程式嗎?
可以。開啟簡報,找出包含 MathPortion 的形狀,呼叫 getMathParagraph,並在該段落中更新數學區塊。
方程式會儲存為可編輯的 PowerPoint 數學嗎?
會。將檔案儲存為 PPTX 時,Aspose.Slides 會將方程式寫入為可編輯的 Office 數學內容。
我可以將方程式匯出為 LaTeX 嗎?
可以。從其 MathPortion 取得 MathParagraph,然後呼叫 MathParagraph.toLatex 直接匯出。完整範例請參閱 從 Node.js via Java 匯出簡報中的數學方程式至 LaTeX。