TCustomRichView.AddHotspot

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.AddHotspot

Добавляет интерактивный значок (изображение-гиперссылку из TImageList) в конец документа.

VCL и LCL:

procedure AddHotspot(const AName: TRVUnicodeString;
  ImageIndex, HotImageIndex: Integer; ImageList: TCustomImageList;
  ParaNo: Integer = -1; VAlign: TRVVAlign = rvvaBaseline; 

  const Tag: TRVTag = RVEMPTYTAG);

FireMonkey:

procedure AddHotspot(const AName: TRVUnicodeString;
  ImageIndex, HotImageIndex: Integer; ImageList: TCustomImageList;
  ParaNo: Integer = -1; VAlign: TRVVAlign = rvvaBaseline; 

  const Tag: TRVTag = RVEMPTYTAG;

  ImageWidth: TRVStyleLength = 16;

  ImageHeight: TRVStyleLength = 16);

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

▪Если нужен такой же элемент, не являющийся гиперссылкой, добавьте значок.

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

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

Параметры:

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

ImageIndex – номер изображения в ImageList.

HotImageIndex – номер изображения в ImageList, показывающегося под указателем мыши.

ImageList – список изображений для значка. TRichView не владеет, не копирует и не удаляет списки изображений, он просто хранит ссылки на них. Поэтому список изображений не уничтожается при очистке документа.

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

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

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

Дополнительные параметры для версии FireMonkey:

ImageWidth, ImageHeight – желательный размер изображения. Компонент выбирает подходящее по размеру изображение. Изображения не масштабируются.

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

См. также методы:

▪Format;

▪FormatTail;

▪SetAddParagraphMode.

См. также методы TRichViewEdit:

▪InsertBullet.

См. также свойства TRVStyle:

▪ParaStyles.

См. также:

▪Типы элементов документа;

▪Другие методы добавления элементов в документ;

▪Теги.

Аналогичные устаревшие методы:

procedure AddHotspotExTag(const Name: TRVUnicodeString;

  ImageIndex, HotImageIndex: Integer;

  ImageList: TCustomImageList; ParaNo: Integer;

  const Tag: TRVTag);

procedure AddHotspotEx(const Name: TRVUnicodeString;

  ImageIndex, HotImageIndex: Integer;

  ImageList: TCustomImageList; ParaNo: Integer);

Эти методы обеспечивают подмножество функциональности AddHotspot.