rvico TRichView Reference | TRichView

TCustomRichView.AddHotPicture, AddHotPictureTag

Top  Previous  Next

These method add picture-hyperlink (gr) with the specified Name and vertical alignment (VAlign) to the end of document.

procedure AddHotPictureTag(const Name: TRVAnsiString;

  gr: TGraphic; ParaNo: Integer;

  VAlign: TRVVAlignconst Tag: TRVTag);


procedure AddHotPicture(const Name: TRVAnsiString

  gr: TGraphic; ParaNo: Integer; VAlign: TRVVAlign);

(introduced in version 1.5)

AddHotPicture provides a subset of functionality of AddHotPictureTag:

AddHotPicture(...) is equivalent to AddHotPictureTag(..., '')

The same as AddPictureEx and AddPictureExTag, but this picture will be a hypertext link.



Name – name of this hot-picture item, any string. Name must not contain CR and LF characters. RichView does not use Names itself, they are for your own use. This is an ANSI string, regardless of Unicode mode of text styles.

gr – picture to insert. By default, this picture will be owned by TRichView control, and you must not free it. However, you can specify nonzero rvepShared extra item property, and this graphic object will be shared (you need to free it yourself after TRichView is cleared).

VAlign – vertical align of this picture, relative to its line, see TRVVAlign for possible values.

If ParaNo=-1, the methods add the item to the end of the last paragraph. If ParaNo>=0, this item starts a new paragraph with the ParaNo-th style. (ParaNo is an index in the ParaStyles collection of the linked RVStyle component). It defines attributes for the new paragraph.

Tagtag of this hot-picture item..



If you want to add a simple (not a hyperlink) TGraphic picture, add a picture instead.

If you want to add a hyperlink-picture from image list, add a hotspot instead.

If you want to add a simple (not a hyperlink) picture from image list, add a bullet instead.


Methods type: viewerstyle viewer-style.

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

See also methods:




See also methods of TRichViewEdit:


See also properties of TRVStyle:


See also:

Item types;

Other methods for appending items;


Hypertext in RichView.

TRichView © trichview.com