TCustomRichView.AddControl

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

TCustomRichView.AddControl

Добавляет визуальный компонент Delphi/Lazarus в конец документа.

procedure AddControl(const AName: TRVUnicodeString; ctrl: TControl;
  ParaNo: Integer = -1; VAlign: TRVVAlign = rvvaBaseline; 

  const Tag: TRVTag = RVEMPTYTAG);

Параметры:

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

ctrl – компонент для вставки. По умолчанию, TRichView будет владеть этим компонентом, и вы не должны уничтожать его. Однако вы можете присвоить ненулевое значение дополнительному свойству элемента rvepShared, тогда этот компонент будет общим (и вам нужно будет освобождать память под него самостоятельно).

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

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

Tag – тег добавляемого элемента. Не следует путать со свойством ctrl.Tag.

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

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

▪Format;

▪FormatTail;

▪SetAddParagraphMode.

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

▪InsertControl.

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

▪ParaStyles.

См. также:

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

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

▪Теги.


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

procedure AddControlExTag(const Name: TRVAnsiString; ctrl: TControl;

  ParaNo: Integer; VAlign: TRVVAlign; const Tag: TRVTag);

procedure AddControlEx(const Name: TRVAnsiString; ctrl: TControl;

  ParaNo: Integer; VAlign: TRVVAlign);

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