Константы rvs***

Существуют три группы констант rvs***:

▪идентификаторы типов элементов документа ТРВ-Редактора;

▪номера элементов в коллекции текстовых стилей (RVStyle.TextStyles), соответствующие начальным элементам;

▪значения, используемые ТРВ-Редактором при сохранении и загрузке RVF-файлов (см. спецификацию RVF).

Идентификаторы типов элементов документа

Используйте первую группу констант для сравнения со значениями, возвращаемыми RichView.GetItemStyle или TRichViewEdit.CurItemStyle.

Здесь и далее имена модулей даны для версии VCL и LCL. Для FireMonkey, если аналогичный модуль имеется, его имя начинается с «fmx», например fmxRVStyle вместо RVStyle.

Константа	Знач.	Тип элемента	Модуль
rvsBreak	-1	горизонтальная линия (разделитель)	RVStyle
rvsPicture	-3	рисунок	RVStyle
rvsHotspot	-4	интерактивный значок (изображение из компонента TImageList - гиперссылка)	RVStyle
rvsComponent	-5	визуальный компонент	RVStyle
rvsBullet	-6	значок (изображение из компонента TImageList)	RVStyle
rvsHotPicture	-10	интерактивный рисунок (рисунок-гиперссылка)	RVStyle
rvsListMarker	-11	маркер списка (нумерация или символ в начале абзаца)	RVStyle
rvsTab	-12	табуляция	RVStyle
rvsTable	-60	таблица	RVTable
rvsLabel	-200	текстовая метка	RVLabelItem
rvsSequence	-202	элемент нумерованной последовательности	RVSeqItem
rvsFootnote	-203	сноска	RVNote
rvsEndnote	-204	концевая сноска	RVNote
rvsSidenote	-206	сноска в рамке	RVSidenote
rvsTextBox	-207	текстовый блок	RVSidenote
rvsNoteReference	-205	ссылка на родительскую сноску	RVNote
rvsPageNumber	-208	поле номера страницы	RVFieldItems
rvsPageCount	-209	поле числа страниц	RVFieldItems
rvsMathEquation	-210	математическое выражение (формула)	RVMathItem
rvsChatFile	-212	файл, приложенный к сообщению чата	RVChat

Типы элементов, входящих в Мастерскую отчётов (ReportWorkshop):

Константа	Знач.	Тип элемента	Модуль
rvsReportTable	-61	отчётная таблица	RVReportTable
rvsShape	-211	геометрическая фигура	RVReportShapeItem
rvsReportChart	-213	график (диаграмма) в отчёте	RVReportChart

Типы элементов из демонстрационных примеров (в каталоге TRichView\Demos\Addins\)

Константа	Знач.	Тип элемента	Модуль
rvsBlendBitmap	-50	полупрозрачное изображение TBitmap	RVBlendBitmap
rvsHotBlendBitmap	-51	полупрозрачное изображение TBitmap - гиперссылка	RVBlendBitmap
rvsChart	-1001	элемент с компонентом TChart	ChartItem
rvsCombo	-201	текстовая метка, показывающая компонент TComboBox	ComboItem

Все эти константы имеют отрицательные значения, поэтому их можно отличить от номеров элементов в коллекции текстовых стилей.

См. также: типы элементов ТРВ-Редактора.

Номера элементов в коллекции текстовых стилей

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

Все эти константы объявлены в модуле RVStyle.

Константа	Знач.	Предлагаемое использование
rvsNormal	0	Обычный текст
rvsHeading	1	Заголовок 1
rvsSubheading	2	Заголовок 2
rvsKeyword	3	Ключевые слова
rvsJump1	4	Гипертекст 1
rvsJump2	5	Гипертекст 2

По-прежнему настоятельно рекомендуется использовать стиль с номером 0 как текстовый стиль по умолчанию (обычный текст). Например, этот стиль используется как стиль по умолчанию в экспортируемых HTML-файлах.

Помимо этого, есть особая константа rvsDefStyle.

Константа	Знач.	Описание
rvsDefStyle	MaxInt	Использование стиля по умолчанию (устарела!)

Эту константу можно использовать в качестве параметра StyleNo в методах, добавляющих текст в компонент TRichView.

Если вместо номера элемента в коллекции текстовых стилей указано это значение, используется текстовый стиль абзаца по умолчанию. Эта возможность устарела – вместо неё используйте StyleTemplates.

Это значение также имеет специальный смысл в событии TRichView.OnReadField.