<< Нажмите, чтобы показать Содержание >> Математические выражения (формулы) в  документе ТРВ-Редактора (TRichView) [VCL]

Элементы этого типа показывают математические выражения. Иногда их называют «уравнениями», хотя математическое выражение не обязательно может представлять собой уравнение.

Класс этого типа элемента: TRVMathItemInfo (см. для подробной информации).

Тип (стиль) этого элемента: rvsMathEquation (-210)

Для использования этого элемента требуется RAD Studio XE4 или более поздняя версия. Этот элемент недоступен в версиях для Lazarus и FireMonkey.

Лицензия

Этот элемент документа использует Математический движок Адит (Adit Math Engine) от Адит Софтвер (Adit Software): aditmath.com

Существует две версии Adit Math Engine: бесплатная и коммерческая.

Бесплатная версия

Модули бесплатной версии Adit Math Engine включены в инсталляцию ТРВ-Редактора (в папке Math). На них распространяется лицензия MPL 2.0 со следующими дополнительными ограничениями:

Использование Adit Math Engine запрещено в любом программном обеспечении для электронного обучения/оценки/тестирования/математики (бесплатном или коммерческом) или вне ТРВ-Редактора без нашего [Adit Software] письменного разрешения.

Вы можете связаться с Adit Software, если хотите использовать Adit Math Engine по другой лицензии или запросить исключение из вышеуказанных ограничений.

Для использования бесплатной версии необходимо включить модуль RVBasicMathWrapper.pas в ваш проект (например, добавить его в раздел uses модуля главной формы).

Бесплатная версия не может загружать уравнения из файлов DocX и HTML и сохраняет их как изображения.

Коммерческая версия

Для использования коммерческой версии необходимо включить модуль RVAdvMathWrapper.pas в ваш проект (например, добавить его в раздел uses модуля главной формы).

Коммерческая версия позволяет сохранять и загружать уравнения в HTML и DocX файлах.

Методы TCustomRichView

Следующие методы быстрого изменения документа добавляют элемент этого типа в конец документа:

▪AddItem (создайте объект TRVMathItemInfo, затем добавьте в документ методом AddItem)

Следующие методы возвращают объект TRVMathItemInfo:

▪GetItem

Методы TCustomRichViewEdit

Следующие методы редактирования документа вставляют элемент этого типа в позицию каретки:

▪InsertItem (создайте объект TRVMathItemInfo, затем вставьте в документ методом InsertItem)

Следующие методы возвращают объект TRVMathItemInfo в позиции каретки:

▪GetCurrentItem.

Следующие методы меняют свойства как операции редактирования:

▪SetCurrentItemExtraIntPropertyEx;

▪SetItemExtraIntPropertyExEd;

▪SetCurrentItemExtraStrPropertyEx;

▪SetItemExtraStrPropertyExEd.

Свойства

Основные свойства:

▪Text – математическое выражение в формате, основанном на LaTeX,

▪DisplayInline – переключение между режимами показа: встроенным и обособленным.

Эти свойства также доступны как rveipcDisplayInline и rvespcText. Изменение их таким способом позволяет реализовать операции редактирования.

Разметка и внешний вид

Элементы этого типа имеют следующие целочисленные свойства, относящиеся к разметке и внешнему виду:

▪rvepSpacing – отступы (зазор между текстом и рамкой; если задан цвет фона, эта область будет закрашена);

▪rvepColor – цвет фона;

▪rvepBorderWidth, rvepBorderColor – ширина и цвет рамки;

▪rvepOuterHSpacing, rvepOuterVSpacing – горизонтальные и вертикальные поля вокруг рамки.

Кроме того, они имеют свойства:

▪FontSizeDouble – размер шрифта в полупунктах,

▪FontName – имя шрифта (можно использовать только специальные математические шрифты),

▪TextColor – цвет текста.

Эти свойства также доступны как rveipcTextColor, rveipcFontSizeDouble и rvespcFontName. Изменение их таким способом позволяет реализовать операции редактирования. Если свойства имеют значения по умолчанию, элемент использует глобальные свойства, заданные в объекте TRVMathDocObject.

Сохранение и загрузка

HTML

▪Бесплатная версия AME: уравнения сохраняются в виде изображений (по возможности в формате PNG). Загрузка уравнений невозможна.

▪Коммерческая версия AME: уравнения сохраняются как объекты MathML (эту функцию можно отключить с помощью свойства RVMathEquationManager.SaveMathMLInHTML). Уравнения можно загружать из HTML.

DocX

▪Бесплатная версия AME: уравнения сохраняются в виде изображений. Загрузка уравнений невозможна.

▪Коммерческая версия AME: уравнения сохраняются как объекты OMML (эту функцию можно отключить с помощью свойства RVMathEquationManager.SaveOMMLInDocX). Уравнения можно загружать из файлов DocX.

RTF

Уравнения сохраняются в виде изображений. Загрузка уравнений невозможна.

Экспорт в Markdown

Уравнения сохраняются в виде изображений (по возможности в формате PNG). Загрузка уравнений невозможна.

Экспорт в текст

Сохраняется значение свойства Text.