在 JavaScript 中將數學方程式加入 PowerPoint 簡報

概述

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

在 PowerPoint 中,使用者通常從 插入 > 方程式 加入方程式:

PowerPoint 插入標籤中已選取方程式指令

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

包含可編輯數學方程式的 PowerPoint 投影片

Aspose.Slides 透過三個主要物件建立該數學文字:

以下大多數範例使用 MathematicalText 以及 MathElementBase 的流暢方法,以保持程式碼簡短且易讀。

若需 MathML 匯出情境,請參閱 從 Node.js via Java 匯出簡報中的數學方程式。

建立方程式

此範例使用 addMathShape 建立數學形狀,並加入畢氏定理:

c² = a² + b² 的方程式

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 選擇分數樣式。

1 ÷ x 的斜分數

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 建立平方根、立方根或其他根。當前元素成為底部,參數則成為指數。

n 次根號(根號下為 x)

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。

x 趨近於無限大的極限

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 開啟現有矩陣,以保留仍然適用的係數。

原始兩列係數矩陣,第一列包含 1、x 並有一個空儲存格,第二列包含 x、2、y

列與欄索引從 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 現在出現在第一與第三欄。

更新後的三列矩陣,顯示列為 1,0,x,0;12,1,0,0;以及 0,0,10,1

加入方程式陣列

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

垂直的數學陣列,x 位於 y 之上

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 位置。

PowerPoint 中方程式陣列,分別使用頂部、中心與底部對齊,且相同的相鄰元素

設定列間距

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 當參數為當前元素且函數名稱已知。

將三角函數 cos 套用於 2x

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。

左側有下標 1 與上標 n 的大寫 Y

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();
}

PowerPoint 中兩個可編輯的表達式,左側 setAlignScripts 為 false,右側為 true

左側的下標起始位置較左,較上標更靠左,遵循基底輪廓。右側的兩個標記則水平對齊。

加入分隔符

使用 enclose 可將表達式包在分隔符之中。對於包含多個元素的分隔符表達式,亦可設定分隔字元。

包含 x、y、z 並以直線分隔的分隔符表達式

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)則在表達式上方稍高。

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 中六個可編輯的分數。上列:完整框線、底部與左側框線、上升對角線。下列:下降對角線、水平刪除線、垂直刪除線,並帶完整框線。

在此分數中,水平刪除線與分數線重疊。垂直刪除線穿過分子與分母,同時保留外圍框線可見。這些線條裝飾整個表達式。普通文字的刪除線僅套用於文字執行序中的字元。重新在 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();
}

PowerPoint 中五個方程式,分別比較可見分數、保留空間的隱藏分數,以及啟用 ZeroWidth、ZeroAsc 或 ZeroDesc 的隱藏分數

分組項目

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

將 x 加 y 的表達式分組,並在下方加上任意文字標籤

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 可在數學元素上方加上一條橫線。

ABC 數學表達式上方有一條橫線

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。