List Markers (Paragraph Bullets & Numbering) in TRichView Documents

<< Click to display table of contents >>

List Markers (Paragraph Bullets & Numbering) in TRichView Documents

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, HTMLSaveProperties.ListMarkerSavingType = rvhtmlmstNormal

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

Export using CSS (HTMLSaveProperties.HTMLSavingType = rvhtmlstNormal):

CSS of lists are partially inserted directly in HTML (as inline attributes), partially are saved in a style sheet.

rvlstBullet, rvlstUnicodeBullet are exported as bullets with default markers (disc, circle or square) if possible. Otherwise, FormatString is used. Font is ignored;

rvlstDecimal, rvlstLowerAlpha, and other numbered list types 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.

Export without CSS (HTMLSaveProperties.HTMLSavingType = rvhtmlstSimplified):

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

rvlstDecimal, rvlstLowerAlpha, and other numbered list types are exported as lists with corresponding numbering (or as decimal, if this numbering type is not supported in HTML). FormatString and Font are ignored;

rvlstImageListCounter is saved as a decimal numbering.

Indents are not saved.

HTML Export, HTMLSaveProperties.ListMarkerSavingType = rvhtmlmstAsText

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

Font and format strings settings are respected.

Saving with CSS (HTMLSaveProperties.HTMLSavingType = rvhtmlstNormal):

LeftIndent and MarkerIndent are retained. FirstIndent are retained for non-hanging markers only (MarkerIndent>=LeftIndent).

Saving without CSS (HTMLSaveProperties.HTMLSavingType = rvhtmlstSimplified):

All indents are ignored.

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

Demo Projects

Demos\*\Assorted\ListStyles\