TCustomRichView.AddBullet

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.AddBullet

Добавляет значок (изображение из TImageList) в конец документа.

VCL и LCL:

procedure AddBullet(const AName: TRVUnicodeString;

  ImageIndex: Integer; ImageList: TCustomImageList; 

  ParaNo: Integer = -1; VAlign: TRVVAlign = rvvaBaseline;

  const Tag: TRVTag = RVEMPTYTAG);

FireMonkey:

procedure AddBullet(const AName: TRVUnicodeString;

  ImageIndex: Integer; ImageList: TCustomImageList;

  ParaNo: Integer = -1; VAlign: TRVVAlign = rvvaBaseline;

  const Tag: TRVTag = RVEMPTYTAG;

  ImageWidth: TRVStyleLength = 16;

  ImageHeight: TRVStyleLength = 16);

Альтернативы:

▪Если нужен такой же элемент, являющийся гиперссылкой, добавьте интерактивный значок.

▪Если нужно обычное изображение, добавьте рисунок.

▪Если нужно обычное изображение, являющееся гиперссылкой, добавьте интерактивный рисунок.

Параметры:

AName – имя элемента-значка, любая строка. AName не должен содержать символы CR и LF . TRichView не использует имена элементов, они предназначены для использования программистом.

ImageIndex – номер изображения в ImageList.

ImageList – список изображений для значка. TRichView не владеет, не копирует и не удаляет списки изображений, он просто хранит ссылки на них. Поэтому список изображений не уничтожается при очистке документа.

Если ParaNo=-1, метод добавляет элемент в конец последнего абзаца. Если ParaNo>=0, добавляемый элемент начинает абзац, имеющий атрибуты, заданные в Style.ParaStyles[ParaNo].

VAlign – выравнивание элемента относительно строки текста, см. возможные значения в разделе о типе TRVVAlign.

Tag – тег добавляемого элемента.

Дополнительные параметры для версии FireMonkey:

ImageWidth, ImageHeight – желательный размер изображения. Компонент выбирает подходящее по размеру изображение. Изображения не масштабируются.

Тип метода: viewerstyle быстрое изменение документа.

См. также методы:

▪Format;

▪FormatTail;

▪SetAddParagraphMode.

См. также методы TRichViewEdit:

▪InsertBullet.

См. также свойства TRVStyle:

▪ParaStyles.

См. также:

▪Типы элементов документа;

▪Другие методы добавления элементов в документ;

▪Теги.

Аналогичные устаревшие методы:

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);

Эти методы обеспечивают подмножество функциональности AddBullet.