TCustomRichView.AddFmt

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

TCustomRichView.AddFmt

Добавляет в конец документа текст, собранный из строки формата и массива значений, с использованием стиля текста с номером StyleNo и стиля абзаца с номером ParaNo.

procedure AddFmt(const FormatStr: String

  const Args: array of const; StyleNo, ParaNo: Integer);

AddFmt(FormatStr, Args, StyleNo, ParaNo) эквивалентен AddNL(Format(FormatStr,Args), StyleNo, ParaNo).
(где Format – не метод TRichView, а функция SysUtils.Format)

Параметры:

FormatStr – строка форматирования текста. Синтаксис см. в разделе «Format function» в справочном файле Delphi. FormatStr не должна содержать символы CR, LF, TAB, FF (#13, #10, #9, #12). Для добавления нескольких абзацев текста используйте AddTextNL.

Args аргументы для строки форматирования.

StyleNo  номер элемента в коллекции TextStyles связанного компонента TRVStyle, или константа rvsDefStyle. Задаёт шрифт, цвет и некоторые другие свойства отображения текста.

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

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

Примечание: в TRichView пустые строки разрешаются только в отдельных абзацах (возможно, после маркеров списка). Исключение составляет только текст стиля, имеющего свойство EmptyWidth>0. См. Корректность документов.

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

юникодная строка (UTF-16) в Delphi/C++Builder 2009 и новее,

ANSI- строка в более старых версиях Delphi/C++Builder.

юникодная строк (UTF-8) в Lazarus

Пример:

MyRichView.AddFmt('X=%d and Y=%d', [X,Y], 00);

Если используются шаблоны стилей, компонент может автоматически изменять номера стилей текста для обеспечения согласованности шаблонов стилей текста и абзаца.

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

AddNL;

AddTextNL;

Format;

FormatTail;

SetAddParagraphMode.

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

TextStyles;

ParaStyles;

SpacesInTab.

См. также:

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