TRichView.AddBulletExTag and Others

TRichView Reference | TRichView

TCustomRichView.AddBulletEx, AddBulletExTag

TCustomRichView.AddBullet (deprecated)

Top Previous Next

These methods add bullet (image from TImageList) to the end of document.

procedure AddBulletExTag(const Name: String;

ImageIndex: Integer; ImageList: TCustomImageList;

ParaNo,Tag: Integer);

procedure AddBulletEx(const Name: String; ImageIndex: Integer;

ImageList: TCustomImageList; ParaNo: Integer);

procedure AddBullet(ImageIndex: Integer; ImageList: TCustomImageList;

fromnewline: Boolean); deprecated;

AddBulletEx provides a subset of functionality of AddBulletExTag:

▪	AddBulletEx(...) is equivalent to AddBulletExTag(..., 0).

AddBullet is deprecated and maintained for backward compatibility (with TRichView versions prior to 1.0):

▪	AddBullet(ImageIndex, ImageList, True) is equivalent to AddBulletEx('', ImageIndex, ImageList, 0).

▪	AddBullet(ImageIndex, ImageList, False) is equivalent to AddBulletEx('', ImageIndex, ImageList, -1).

Alternatives:

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

▪	If you want to add a TGraphic picture, add a picture instead.

▪	If you want to add a TGraphic picture-hyperlink, add a hot picture instead.

Parameters:

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

ImageIndex – index of image in ImageList.

ImageList – image list for this bullet. RichView does not own, does not copy and does not destroy imagelists, it just holds pointers to them. So this image list is not destroyed when the document is cleared.

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.

Tag – tag of this bullet.

Methods type: viewer-style.

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