rvico TRichView Reference | TRichView

TCustomRichView.AddBullet

Top  Previous  Next

Adds a bullet (an image from TImageList) to the end of document.

procedure AddBullet(const Name: TRVUnicodeString; ImageIndex: Integer;
  ImageList: TCustomImageList; ParaNo: Integer = -1;
  VAlign: TRVVAlign = rvvaBaseline; const Tag: TRVTag = RVEMPTYTAG);

(changed in version 18)

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. TRichView does not use item names itself, they are for your own use.

ImageIndex – index of image in ImageList.

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

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].

Tagtag of this bullet.

Method type: viewerstyle viewer-style.

See also methods:

Format;

FormatTail;

SetAddParagraphMode.

See also methods of TRichViewEdit:

InsertBullet.

See also properties of TRVStyle:

ParaStyles.

See also:

Item types;

Other methods for appending items;

"Tags".


Related deprecated methods:

procedure AddBulletExTag(const Name: TRVUnicodeString

  ImageIndex: Integer; ImageList: TCustomImageList;

  ParaNo: Integer; const Tag: TRVTag);

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

  ImageList: TCustomImageList; ParaNo: Integer);

These methods provide subset of functionality of AddBullet.


TRichView © trichview.com