rvico TRichView Reference | TRichViewEdit

TCustomRichViewEdit.GetCurrentHotspotInfo

Top  Previous  Next

Returns main properties for the item of hotspot type at the position of caret.

procedure GetCurrentHotspotInfo(var AName: TRVAnsiString;

  var AImageIndex, AHotImageIndex: Integer;

  var AImageList: TCustomImageList;

  var ATag: TRVTag);

GetCurrentHotspotInfo(...) is equivalent to TopLevelEditor.GetHotspotInfo(TopLevelEditor.CurItemNo, ...).

Output parameters:

AName – name of hotspot. It can also be read using GetCurrentItemText method.

AImageList – image list (a reference to image list, do not free it).

AImageIndex – index in AImageList for normal image. It can also be read using GetCurrentItemExtraIntPropertyEx method.

AHotImageIndex – index in AImageList for "hot" image. This image is displayed under the mouse pointer (in hypertext mode), or when user moves the caret to this item (in TRichViewEdit). It can also be read using GetCurrentItemExtraIntPropertyEx method.

ATag tag of the item. Use SetCurrentTag or SetCurrentHotspotInfo to change tag of item as an editing operation. This value can also be read using GetCurrentTag method.

 

This method must be called only when the document is formatted.

unicode Unicode note: names of non-text items are ANSI strings.

Additional properties of item at the position of caret are returned by the methods GetCurrentItemExtraIntProperty and GetCurrentItemExtraStrProperty.

See also methods:

SetCurrentHotspotInfo (changes properties of hotspot at the position of caret, as an editing operation);

GetHotspotInfo (returns properties of the specified hotspot).

See also properties:

CurItemNo;

CurItemStyle.

See also:

Obtaining RichView items;

Item types;

"Tags".


TRichView © trichview.com