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], 0, 0);

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

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

▪AddNL;

▪AddTextNL;

▪Format;

▪FormatTail;

▪SetAddParagraphMode.

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

▪TextStyles;

▪ParaStyles;

▪SpacesInTab.

См. также:

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