|
<< Нажмите, чтобы показать Содержание >> 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].
Тип метода:
быстрое изменение документа.
Примечание: в TRichView пустые строки разрешаются только в отдельных абзацах (возможно, после маркеров списка). Исключение составляет только текст стиля, имеющего свойство EmptyWidth>0. См. Корректность документов.
Примечание про Юникод: параметр этого метода:
▪юникодная строка (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;
▪Format;
См. также свойства TRVStyle:
См. также: