rvico 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: TRVAnsiString

  ImageIndex: Integer; ImageList: TCustomImageList;

  ParaNo: Integer; const Tag: TRVTag);

 

procedure AddBulletEx(const Name: TRVAnsiString; 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(..., '').

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

Tagtag of this bullet.

 

Methods type: viewerstyle viewer-style.

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

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


TRichView © trichview.com