<< Click to display table of contents >> TCustomRichView.AddHotPicture |
Adds picture-hyperlink to the end of document.
procedure AddHotPicture(const Name: TRVUnicodeString;
gr: TRVGraphic; ParaNo: Integer = -1;
VAlign: TRVVAlign = rvvaBaseline;
const Tag: TRVTag = RVEMPTYTAG;
ImageWidth: TRVStyleLength = 0;
ImageHeight: TRVStyleLength = 0);
(introduced in version 1.5; changed in versions 18 and 21)
The same as AddPicture, but this picture will be a hypertext link.
Parameters:
Name – name of this hot-picture item, any string. Name must not contain CR and LF characters. TRichView does not use Names itself, they are for your own use.
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).
Rarely used images may be "deactivated", i.e. stored in a memory stream and destroyed (see RichViewMaxPictureCount). Shared images are never deactivated.
VAlign – vertical align of this picture, relative to its line, see TRVVAlign for possible values.
If ParaNo=-1, the method adds an item to the end of the last paragraph. If ParaNo>=0, this item starts a new paragraph using attributes defined in Style.ParaStyles[ParaNo].
Tag – tag of this hot-picture item..
The image is displayed stretched to ImageWidth x ImageHeight (if they are non-zero, see rvepImageWidth and rvepImageHeight in IDH_Type_TRVExtraItemProperty).
Alternatives:
▪If you want to add a simple (not a hyperlink) 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: viewer-style.
See also methods:
▪Format;
See also methods of TRichViewEdit:
See also properties of TRVStyle:
See also:
▪Other methods for appending items;
▪"Tags";
Related deprecated methods:
procedure AddHotPictureTag(const Name: TRVUnicodeString;
gr: TGraphic; ParaNo: Integer;