<< Нажмите, чтобы показать Содержание >> Значки в документе ТРВ-Редактора (TRichView)

Значок – это изображение из TImageList. Значки полезны, если вы хотите создать документ, в котором одно и то же (небольшое) изображение используется много раз.

Например, они могут быть использованы для добавления смайликов в чат.

Этот элемент не имеет отношения к значкам и нумерации списков абзацев.

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

Чтобы сделать значок гиперссылкой, см. тип элемента интерактивный значок.

Методы TCustomRichView

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

▪AddBullet

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

▪SetBulletInfo

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

▪GetBulletInfo

Методы TCustomRichViewEdit

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

▪InsertBullet

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

▪SetCurrentBulletInfo,

▪SetBulletInfoEd

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

GetCurrentBulletInfo

Свойства

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

Ссылка на компонент TImageList задаётся при создании элемента. Она не может быть изменена.

Номер изображения может быть изменён вышеперечисленными методами. Также он доступен как свойство rveipcImageIndex.

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

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

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

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

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

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

Вертикальная позиция

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

▪VAlign;

▪целочисленные свойства: rvepVShift, rvepVShiftAbs.

Растяжение

Размеры значков не могут быть изменены мышью.

В VCL и Lazarus для значков используются размеры, заданные в компоненте TImageList.

В FireMonkey желаемый размер значка задаётся при его создании. Он доступен как целочисленные свойства rvepImageWidth и rvepImageHeight.

Другие свойства

Элементы этого типа имеют следующие строковые свойства:

▪rvespAlt – текстовое представление изображения, сохраняется в HTML как атрибут <IMG alt>.

Использование памяти

Компонент TRichView не владеет компонентом TImageList и не освобождает память под него.

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

RVF

Сами списки изображений (ImageLists) не сохраняются в RVF. TRichView сохраняет значение свойства TImageList.Tag. При загрузке срабатывает событие OnRVFImageListNeeded, позволяющее предоставлять списки изображений для значков.

Экспорт в RTF, DocX, Markdown, и HTML

Значки сохраняются как изображения. Если вы хотите переопределить сохранение в HTML, используете событие OnHTMLSaveImage.