TCustomRichViewEdit.GetCurrentHotspotInfo

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

TCustomRichViewEdit.GetCurrentHotspotInfo

Возвращает значения основных свойств элемента-интерактивного значка в позиции каретки.

VCL и LCL:

procedure GetCurrentHotspotInfo(out AName: TRVUnicodeString;

  out AImageIndex, AHotImageIndex: Integer;

  out AImageList: TCustomImageList;

  out ATag: TRVTag);

FireMonkey:

procedure GetCurrentHotspotInfo(out AName: TRVUnicodeString;

  out AImageIndex, AHotImageIndex: Integer;

  out AImageList: TCustomImageList;

  out ATag: TRVTag;

  out AImageWidth, AImageHeight: TRVStyleLength);

Вызов GetCurrentHotspotInfo(...) эквивалентен вызову TopLevelEditor.GetHotspotInfo(TopLevelEditor.CurItemNo, ...).

Выходные параметры:

AName – имя элемента. Оно также может быть получено методом GetCurrentItemText.

AImageList – компонент-список изображений (ссылка на него; не освобождайте память под значение, возвращённое в этом параметре).

AImageIndex – номер изображения в AImageList. Он также может быть получен методом GetCurrentItemExtraIntPropertyEx.

AHotImageIndex – номер изображения в AImageList, показываемого под указателем мыши в режиме гипертекста, или когда каретка перемещается к этому элементу. Он также может быть получен методом GetCurrentItemExtraIntPropertyEx.

ATag – тег элемента. Используйте SetCurrentTag или SetCurrentBulletInfo для его изменения. Он также может быть получен методом GetCurrentTag.

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

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

Этот метод следует вызывать только тогда, когда документ отформатирован.

Другие свойства элемента в позиции каретки можно получить методами GetCurrentItemExtraIntProperty и GetCurrentItemExtraStrProperty.

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

▪SetCurrentHotspotInfo (меняет значение свойств интерактивного значка в позиции каретки, операция редактирования);

▪GetHotspotInfo (возвращает значения свойств указанного интерактивного значка).

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

▪CurItemNo;

▪CurItemStyle.

См. также:

▪Получение элементов документа;

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

▪Теги.