TRichView.AddHotPicture

Добавляет интерактивный рисунок в конец документа.

procedure AddHotPicture(const Name: TRVUnicodeString;

gr: TRVGraphic; ParaNo: Integer = -1;

VAlign: TRVVAlign = rvvaBaseline;

const Tag: TRVTag = RVEMPTYTAG;

ImageWidth: TRVStyleLength = 0;

ImageHeight: TRVStyleLength = 0);

Это аналог AddPicture, но добавляемый элемент является гиперссылкой.

Параметры:

AName – имя элемента-рисунка, любая строка. AName не должен содержать символы CR и LF . TRichView не использует имена элементов, они предназначены для использования программистом.

gr – добавляемое изображение. По умолчанию, TRichView будет владеть этим изображением, и вы не должны уничтожать его. Однако вы можете присвоить ненулевое значение дополнительному свойству элемента rvepShared, тогда этот элемент будет общим (и вам нужно будет освобождать память под него самостоятельно).

Редко используемые изображения могут быть «деактивированы», то есть сохранены в потоки в памяти и уничтожены (см. RichViewMaxPictureCount). Общие изображения никогда не деактивируются.

VAlign – выравнивание элемента относительно строки текста, см. возможные значения в разделе о типе TRVVAlign.

Если ParaNo=-1, метод добавляет элемент в конец последнего абзаца. Если ParaNo>=0, добавляемый элемент начинает абзац, имеющий атрибуты, заданные в Style.ParaStyles[ParaNo].

Tag – тег добавляемого элемента.

Изображение будет показано растянутым до размера ImageWidth x ImageHeight (если эти свойства имеют положительные значения, см. rvepImageWidth и rvepImageHeight в TRVExtraItemProperty).

Альтернативы:

▪Если нужно обычное изображение (не гиперссылка), добавьте рисунок.

▪Если нужна гиперссылка-изображение из TImageList, добавьте интерактивный значок.

▪Если нужно изображение из TImageList (не гиперссылка), добавьте значок.

Тип метода: быстрое изменение документа.