rvico TRichView Reference | TRichViewEdit

TCustomRichViewEdit.GetCurrentBulletInfo

Top  Previous  Next

Returns main properties for the item of bullet type at the position of caret.

procedure GetCurrentBulletInfo(var AName: String;

  var AImageIndex: Integer; var AImageList: TCustomImageList;

  var ATag: Integer);

GetCurrentBulletInfo(...) is equivalent to TopLevelEditor.GetBulletInfo(TopLevelEditor.CurItemNo, ...).

Output parameters:

AName – name of bullet. It can also be read using GetCurrentItemText method.

AImageList – image list (a reference to image list, do not free it).

AImageIndex – index in AImageList.

ATag tag of the item.If tags are pointers to dynamically allocated strings (rvoTagsArePChars in Options), this procedure returns a pointer to this string (you can convert returned ATag to PChar), not to the copy of it, so you should not free it. Use SetCurrentTag or SetCurrentBulletInfo to change tag of item as an editing operation. This value can also be read using GetCurrentTag method.

 

This method must be called only when the document is formatted.

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

Additional properties of item at the position of caret are returned by the methods GetCurrentItemExtraIntProperty and GetCurrentItemExtraStrProperty.

See also methods:

SetCurrentBulletInfo (changes properties of bullet at the position of caret, as an editing operation);
GetBulletInfo (returns properties of the specified bullet).

See also properties:

CurItemNo;
CurItemStyle.

See also:

Obtaining RichView items;
Item types;
"Tags".


RichView © Sergey Tkachenko