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

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

function SetControlInfo(ItemNo: Integer; const AName: TRVUnicodeString;

  AVAlign: TRVVAlign; const ATag: TRVTag): Boolean;

Параметры:

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

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

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

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

 

Возвращаемое значение:

True, если требуется переформатирование (что возможно при изменении вертикального выравнивания).

 

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

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

Примечание: текущая версия ТРВ-Редактора не позволяет менять сам компонент.

 

Пример

RichView1.SetControlInfo(ItemNo, 'мой компонент', 

  rvvaBaseline, тег компонента');

 

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

▪GetControlInfo;

▪GetItemStyle;

▪Format;

▪SetItemExtraIntProperty;

▪SetItemExtraStrProperty.

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

▪ItemCount.

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

▪SetControlInfoEd;

▪SetCurrentControlInfo.

См. также:

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

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

▪Теги.