TCustomRichView.SetBulletInfo

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

TCustomRichView.SetBulletInfo

Изменяет основные свойства элемента-значка.

VCL и LCL:

procedure SetBulletInfo(ItemNo: Integer; const AName: TRVUnicodeString;

  AImageIndex: Integer; AImageList: TCustomImageList;

  const ATag: TRVTag);

FireMonkey:

procedure SetBulletInfo(ItemNo: Integer; const AName: TRVUnicodeString;

  AImageIndex: Integer; AImageList: TCustomImageList;

  const ATag: TRVTag;

  AImageWidth, AImageHeight: TRVStyleLength);

Параметры:

ItemNo – номер элемента. Элемент должен быть значком или интерактивным значком (rvsBullet или rvsHotspot), в противном случае метод вызывает исключение ERichViewError. Элементы документа нумеруются от 0 до ItemCount-1, GetItemStyle возвращает тип элемента. Элементы поддокументов (ячеек таблиц) не включены в диапазон элементов основного документа; для элементов в ячейках используйте Cell.GetRVData.SetBulletInfo.

AName – имя элемента. Произвольная строка без символов переноса строки (CR и LF). Оно также может быть изменено методом SetItemText.

AImageIndex – номер изображения в компоненте TImageList. Он также может быть изменён методом SetItemExtraIntPropertyEx.

ATag – тег элемента. Можно получить методами GetBulletInfo или GetItemTag. Он также может быть изменён методом SetItemTag.

Дополнительные параметры FireMonkey:

AImageWidth, AImageHeight – желательный размер изображения. Выбирается самый подходящий по размеру вариант изображения. Он не масштабируется.

 

Тип метода: viewerstyle быстрое изменение документа. Если размер изображения не меняется, то не обязательно переформатировать документ, достаточно перерисовать.

Дополнительные свойства элемента можно поменять методами SetItemExtraIntProperty и SetItemExtraStrProperty.

 

Пример:

RichView1.SetBulletInfo(ItemNo, 'моя картинка', 0, nil, 'тег значка');

 

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

▪GetBulletInfo;

▪GetItemStyle;

▪SetItemExtraIntProperty;

▪SetItemExtraStrProperty.

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

▪ItemCount.

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

▪SetBulletInfoEd;

▪SetCurrentBulletInfo.

См. также:

▪Изменение свойств элементов документа;

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

▪Теги.