TCustomRichView.AddNL, AddNLA, AddNLW, Add

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

TCustomRichView.AddNL, AddNLA, AddNLW, Add

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

procedure AddNL(const s: String; StyleNo: Integer; ParaNo: Integer = -1;

  const Tag: TRVTag = RVEMPTYTAG);
procedure AddNLW(const s: TRVUnicodeString; StyleNo, ParaNo: Integer;

  const Tag: TRVTag = RVEMPTYTAG);
procedure AddNLA(const s: TRVAnsiString; StyleNo, ParaNo: Integer;
  const Tag: TRVTag = RVEMPTYTAG);

procedure Add(const s: String; StyleNo:Integer);

Параметры:

s – добавляемая текстовая строка.  Она не должна содержать символы CR, LF, TAB, FF (#13, #10, #9, #12). Для добавления нескольких абзацев текста используйте AddTextNL.

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

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

Tag – тег добавляемого элемента.

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

Add обеспечивает часть функциональности AddNL: Add(...) эквивалентно AddNL..., -1, '').

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

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

В компоненте строки хранятся в юникодном формате. AddNLA конвертирует ANSI-строку в юникодную. Кодировка для конвертации определяется по значению свойства Style.TextStyles[StyleNo].Charset. Если она равна DEFAULT_CHARSET, и для нетекстовых элементов, используется Style.DefCodePage.

AddNL работает:

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

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

▪со строками в кодировке UTF-8 в Lazarus

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

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

▪AddTab;

▪Format;

▪FormatTail;

▪SetAddParagraphMode.

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

▪InsertStringTag, InsertStringATag, InsertStringWTag.

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

▪TextStyles;

▪SpacesInTab.

См. также:

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

▪Юникод в ТРВ-Редакторе.

Аналогичные устаревшие методы:

procedure AddNLTag(const s: String; StyleNo, ParaNo: Integer;

  const Tag: TRVTag);
procedure AddTag(const s: String; StyleNo: Integer; const Tag: TRVTag);
procedure AddNLATag(const s: TRVAnsiString; StyleNo, ParaNo: Integer;

  const Tag: TRVTag);
procedure AddNLWTag(const s: TRVUnicodeString; StyleNo, ParaNo: Integer;

  const Tag: TRVTag)