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: TRVVAlignconst Tag: TRVTag);

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

  ParaNo: Integer; VAlign: TRVVAlign);

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