Добавление математических уравнений в презентации PowerPoint на JavaScript
Обзор
PowerPoint хранит уравнения в виде Office Math Markup Language (OMML). С помощью Aspose.Slides for Node.js via Java вы можете программно создавать такие же математические конструкции: дроби, радикалы, функции, пределы, N‑арные операторы, матрицы, массивы и отформатированные математические блоки.
В PowerPoint пользователи обычно добавляют уравнения через Insert > Equation:

Результат — редактируемый математический текст на слайде:

Aspose.Slides создает этот математический текст с помощью трех основных объектов:
- Математическая фигура, созданная с помощью addMathShape, — это объект, содержащий уравнение.
- MathPortion хранит математическое содержимое внутри текстового фрейма фигуры.
- MathParagraph содержит один или несколько объектов MathBlock.
Большинство примеров ниже используют MathematicalText и цепочечные методы из MathElementBase, чтобы код был коротким и читаемым.
Для сценариев экспорта MathML смотрите Экспорт математических уравнений из презентаций в Node.js через 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();
}
Note
addMathShape создает фигуру, уже содержащую математический абзац. Получите первый MathPortion, вызовите getMathParagraph, и добавьте к нему математические блоки или элементы.Объединение MathBlock’ов
Когда части уравнения создаются независимо как объекты 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², при этом все три степени сохраняются как надстрочные индексы.
Вызов add как leftBlock.add(rightBlock) пытается вложить один блок внутрь другого и бросает 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. Метод setHideDegree класса MathRadical управляет тем, какая форма отображается. Обе формы сохраняют степень 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, чтобы сохранить применимые коэффициенты.

Индексы строк и столбцов начинаются с нуля и относятся к текущему состоянию матрицы при каждом вызове. Вставка строки перед индексом 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 задаёт числовое значение для явного правила интервала и игнорируется предустановленными правилами.
Для точного интервала значение измеряется в пунктах. Для пропорционального интервала измеряется в половинных линиях: значение 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 для восходящей диагонали (↗) или в 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 вы всё ещё можете независимо редактировать числитель и знаменатель.
Управление видимостью и размещением с помощью Phantom-элементов
Поместите выражение в MathPhantom, чтобы независимо управлять его видимостью и тем пространством, которое оно занимает в уравнении. Методы MathPhantom управляют следующим:
| Метод | Эффект |
|---|---|
| setShow | Передайте false, чтобы скрыть выражение. Его размеры всё равно учитываются при размещении, если ниже не передать true. |
| setZeroWidth | Рассматривает горизонтальную ширину выражения как ноль, позволяя соседним элементам приближаться друг к другу. |
| setZeroAsc | Считается, что подъём (высота над базовой линией) равен нулю, что может уменьшить пространство над соседними элементами. |
| setZeroDesc | Считается, что спад (глубина ниже базовой линии) равен нулю, что может приблизить дробную черту или другое содержимое ниже выражения к соседям. |
Базовая линия — это референтная линия, на которой находятся обычные математические символы. Скрытие содержимого не удаляет его размеры, а трактовка размера как нуля не удаляет само выражение. Исходное выражение остаётся доступным через getBase. Передайте true в setShow, чтобы снова отобразить его; настройки размеров сохраняются.
Пример ниже создаёт пять вариантов рядом: видимую дробь, скрытую дробь, сохраняющую место, и три скрытые дроби, у которых одна из размеров считается нулём. Каждый вариант использует то же окружающее выражение и Cambria Math размером 24 пункта. Все фигуры уравнений имеют одинаковую верхнюю позицию, отмеченную серой направляющей. Размещение phantom‑элемента в числителе внешней дроби упрощает визуальное восприятие вертикальных изменений.
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();
}
Форматирование Math-элементов
Используйте вспомогательные функции форматирования только там, где они проясняют формулу. Например, 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();
}
Форматирование текста в существующем уравнении
Чтобы отформатировать текст во всём существующем уравнении, пройдитесь по дереву элементов каждого MathBlock. MathElementBase.getChildren возвращает только непосредственных потомков, поэтому вызывайте его рекурсивно, чтобы добраться до текста внутри дробей, индексов, радикалов и других вложенных структур. Проверяйте текущий элемент и его потомков, чтобы включить начальный элемент, если он является MathematicalText.
Этот пример предполагает, что input.pptx содержит уравнение вроде z = xᵢ / ∛y, где дробь содержит нижний индекс в числителе и радикал в знаменателе. Обработка только верхнего уровня блока пропустит текст внутри дроби. Пример ищет математические части в текстовых фреймах слайдов, получает их блоки через MathPortion.getMathParagraph и использует setFontHeight для установки размера шрифта 28 пунктов через метод getFormat каждого текстового элемента.
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 |
FAQ
Могу ли я редактировать существующее уравнение PowerPoint?
Да. Откройте презентацию, найдите фигуру, содержащую MathPortion, вызовите getMathParagraph и обновите математические блоки в этом абзаце.
Сохраняются ли уравнения как редактируемая математика PowerPoint?
Да. При сохранении в PPTX Aspose.Slides записывает уравнение как редактируемое содержание Office Math.
Могу ли я экспортировать уравнения в LaTeX?
Да. Получите MathParagraph уравнения из его MathPortion и вызовите MathParagraph.toLatex для прямого экспорта. Полный пример смотрите в Экспорт математических уравнений из презентаций в Node.js через Java.