TRichView Reference | Item Types

List Markers (Paragraph Bullets & Numbering)

This is a very special item type representing paragraph bullet or number.

Style of this item type: rvsListMarker (-11)

See also: numbered sequences.

Properties of List Markers

TRVStyle component has a collection of list styles (ListStyles). Each list style contains a collection of list levels (Levels property). List level defines the most of list properties.

List markers is a special kind of items. They are inserted with special functions. They are always inserted at the beginning of paragraph.

They have the following properties:

▪ListNo – index of list style in the collection of list styles;

▪LevelNo – list level;

▪StartFrom – starting value for list counter, if UseStartFrom=True;

▪UseStartFrom – if True, list counter value for this marker is defined by StartFrom. If False, numbering is continued.

List Markers Operations

Methods of TCustomRichView:

▪SetListMarkerInfo,

▪GetListMarkerInfo,

▪RefreshListMarkers.

Methods of TCustomRichViewEdit:

▪ApplyListStyle,

▪RemoveLists,

▪ChangeListLevels.

Saving and Loading

RVF

For list levels with ImageLists: ImageLists themselves are not saved in RVF. RichView stores TImageList.Tag. When loading, OnRVFImageListNeeded occurs allowing you to provide an image-list.

HTM Export, rvsoMarkersAsText is not in Options of SaveHTML or SaveHTMLEx

Lists are saved using <ul> and <ol> HTML tags.

Export using CSS (SaveHTMLEx):

CSS of lists are inserted directly in HTML.

▪rvlstBullet, rvlstUnicodeBullet are exported as bullets with default markers (disc, circle or square). FormatString and Font are ignored;

▪rvlstDecimal,rvlstLowerAlpha,rvlstUpperAlpha,rvlstLowerRoman,rvlstUpperRoman are exported as lists with corresponding numbering. FormatString and Font are ignored;

▪rvlstPicture,rvlstImageList,rvlstImageListCounter are exported as bullets with picture. It's possible to change default image saving by OnHTMLSaveImage.

Indents are saved, but not very accurately.

Export without CSS (SaveHTML)

▪rvlstBullet, rvlstUnicodeBullet,rvlstPicture,rvlstImageList are exported as bullets with default markers (disc, circle or square). FormatString, Picture, ImageList and Font are ignored;

▪rvlstDecimal,rvlstLowerAlpha,rvlstUpperAlpha,rvlstLowerRoman,rvlstUpperRoman are exported as lists with corresponding numbering. FormatString and Font are ignored;

▪rvlstImageListCounter is saved as a decimal numbering.

Indents are not saved.

HTML Export, rvsoMarkersAsText is in Options

Markers are saved without using special HTML keywords for lists (like <ol>, <ul>, <li>).

Font and format strings settings are respected.

Saving with CSS (SaveHTMLEx): LeftIndent and MarkerIndent are retained. FirstIndent are retained for non-hanging markers only (MarkerIndent>=LeftIndent).

Saving without CSS (SaveHTML): all indents are ignored.

Generally, HTML files saved with this option look closer to the original.

Demo Projects

▪Demos\Delphi\Assorted\ListStyles\

▪Demos\CBuilder\Assorted\ListStyles\