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

Вставляют текстовую строку s (без символов переноса) с тегом Tag в позицию каретки.

function InsertStringTag(const s: String;

  const Tag: TRVTag): Boolean;

function InsertStringATag(const s: TRVAnsiString;

  const Tag: TRVTag): Boolean;

function InsertStringWTag(const s: TRVUnicodeString;

  const Tag: TRVTag): Boolean;

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

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

В отличие от InsertText в этих методах:

▪параметр s не должен содержать символы CR, LF (#13 и #10) и символ разрыва страницы (#12);

▪символы табуляции всегда заменяются пробелами, даже если SpacesInTab=0.

▪вставленная строка не объединяется с соседними текстовыми элементами, даже если имеет тот же стиль текста и тег.

Используйте этот метод только при необходимости. Обычно использование InsertText предпочтительнее.

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

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

InsertStringTag работает:

▪как InsertStringATag в Delphi 2007 и старее

▪как InsertStringWTag в Delphi 2009 и новее

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

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

True при успешной вставке (вставка может быть неуспешной из-за защиты документа, режима только для чтения, или если выделены несколько ячеек таблицы)

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

▪InsertText, -A, -W.

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

▪CurParaStyleNo;

▪CurTextStyleNo.

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

▪TextStyles;

▪ParaStyles;

▪SpacesInTab.

См. также:

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

▪Теги.