TCustomRichViewEdit.InsertText, InsertTextA, InsertTextW

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

TCustomRichViewEdit.InsertText, InsertTextA, InsertTextW

Вставляют текстовую строку text (возможно, включающую символы переноса) в позицию каретки.

procedure InsertText(const text: String;

  CaretBefore: Boolean=False);

procedure InsertTextA(const text: TRVAnsiString;

  CaretBefore: Boolean=False);

procedure InsertTextW(const text: TRVUnicodeString;

  CaretBefore: Boolean=False);

Вставленный текст (один или несколько элементов) имеет текущий стиль текста и текущий стиль абзаца.

Text может содержать специальные символы: CR, LF, TAB, FF (#13, #10, #9, #12). Символы #9 могут быть вставлены как табуляции или заменены на пробелы, в зависимости от значения свойства SpacesInTab связанного компонента TRVStyle. Символы #12 добавляют разрывы страницы. Поддерживаются все возможные сочетания переноса строк (CR, LF, CR+LF, LF+CR).

InsertTextW поддерживает маркеры порядка байтов Юникода (если такой символ есть, он должен быть первым в text).

Если CaretBefore=True, каретка перемещается в начало вставленного текста (по умолчанию она перемещается в его конец). Значение True может быть полезным при поиске и замене в направлении от конца к началу документа, чтобы избежать зацикливания (например, при замене 'a' на 'aa'). Опция поиска «умный старт» решает эту проблему по-другому; однако совет об использовании этого параметра остаётся в силе.

Тип методов: editstyle редактирование документа (вставка).

unicode Примечание про Юникод:

В компоненте весь текст хранится в юникодной кодировке. InsertTextA конвертирует ANSI в Юникод на основе Style.DefCodePage.

InsertText работает:

как InsertTextA в Delphi 2007 и старее

как InsertTextW в Delphi 2009 и новее

со строкой UTF-8 в Lazarus

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

InsertStringTag, InsertStringATag, InsertStringWTag.

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

CurParaStyleNo;

CurTextStyleNo.

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

TextStyles;

ParaStyles;

SpacesInTab.

См. также:

Вставка элементов документа в позицию каретки.