TCustomRichView.SetHotspotInfo

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

TCustomRichView.SetHotspotInfo

Изменяет основные свойства элемента-интерактивного значка.

VCL и LCL:

procedure SetHotspotInfo(ItemNo: Integer;

  const AName: TRVUnicodeString;

  AImageIndex, AHotImageIndex: Integer;

  AImageList: TCustomImageList;

  const ATag: TRVTag);

FireMonkey:

procedure SetHotspotInfo(ItemNo: Integer;

  const AName: TRVUnicodeString;

  AImageIndex, AHotImageIndex: Integer;

  AImageList: TCustomImageList;

  const ATag: TRVTag;

  AImageWidth, AImageHeight: TRVStyleLength);

Параметры:

ItemNo – номер элемента. Элемент должен быть интерактивным значком (rvsHotspot), в противном случае метод вызывает исключение ERichViewError. Элементы документа нумеруются от 0 до ItemCount-1, GetItemStyle возвращает тип элемента. Элементы поддокументов (ячеек таблиц) не включены в диапазон элементов основного документа; для элементов в ячейках используйте Cell.GetRVData.SetHotspotInfo.

AName – имя элемента. Произвольная строка без символов переноса строки (CR и LF). Оно также может быть изменено методом SetItemText.

AImageIndex – номер изображения в компоненте TImageList. Он также может быть изменён методом SetItemExtraIntPropertyEx.

AHotImageIndex – номер изображения в компоненте TImageList, использующегося, когда элемент находится под указателем мыши. Он также может быть изменён методом SetItemExtraIntPropertyEx.

ATag – тег элемента. Можно получить методами GetBulletInfo или GetItemTag. Он также может быть изменён методом SetItemTag.

Дополнительные параметры FireMonkey:

AImageWidth, AImageHeight – желательный размер изображения. Выбирается самый подходящий по размеру вариант изображения. Он не масштабируется.

 

Тип метода: viewerstyle быстрое изменение документа. Если размер изображения не меняется, то не обязательно переформатировать документ, достаточно перерисовать.

Дополнительные свойства элемента можно поменять методами SetItemExtraIntProperty и SetItemExtraStrProperty.

 

Пример:

RichView1.SetHotspotInfo(ItemNo, 'моя картинка', 0, 0, nil, 'тег значка');

 

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

▪GetHotspotInfo;

▪GetItemStyle;

▪SetItemExtraIntProperty;

▪SetItemExtraStrProperty.

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

▪ItemCount.

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

▪SetHotspotInfoEd;

▪SetCurrentHotspotInfo.

См. также:

▪Изменение свойств элементов документа;

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

▪Теги.