TCustomRichView.LoadText, LoadTextW

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

TCustomRichView.LoadText, LoadTextW

Добавляют содержимое текстового файла FileName в конец документа. LoadText загружает текст в указанной кодировке, LoadTextW загружает юникодный (UTF-16) текстовый файл.

function LoadText(const FileName: TRVUnicodeString;

  StyleNo, ParaNo: Integer;  AsSingleParagraph: Boolean; 

  CodePage: Cardinal=CP_ACP):Boolean;

 

function LoadTextW(const FileName: TRVUnicodeString;

  StyleNo, ParaNo: Integer; 

  DefAsSingleParagraph: Boolean):Boolean;

Несмотря на своё название, эти методы не очищают существующий документ перед загрузкой. Чтобы заменить текущий документ содержимым этого файла, вызовите метод Clear перед загрузкой (и, возможно, метод DeleteUnusedStyles после Clear).

Параметры:

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

ParaNo номер стиля абзаца, который будет применён к добавляемому тексту. Он задаёт атрибуты добавляемых абзацев.

AsSingleParagraphDefAsSingleParagraph):

False  –  методы используют текущий режим добавления абзацев (см. SetAddParagraphMode);

True – методы добавляют текст как один абзац (добавляют первую строку в текущем режиме добавления абзацев, устанавливают режим добавления абзацев в False, добавляют остальные строки, восстанавливают прежний режим добавления абзацев). DefAsSingleParagraph влияет только на обработку символов CR и LF. Символ WideChar($2029) (разделитель абзацев) всегда добавляет абзац. Символ WideChar($2028) (разделитель строк) всегда добавляет новую строку.

CodePage кодировка для преобразования текста из файла в Юникод.

LoadTextW поддерживает маркеры порядка байтов (если маркер есть, он должен быть первым символом в файле).

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

 

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

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

«Было ли чтение успешным?»

 

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

LoadTextFromStream, LoadTextFromStreamW;

AddTextNLA, AddTextNLW;

Format;

FormatTail;

SetAddParagraphMode;

SaveText, SaveTextW.

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

InsertTextFromFile, InsertTextFromFileW.

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

TextStyles;

SpacesInTab.

См. также:

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

Сохранение и загрузка;

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

Как загрузить текст из файла в кодировке UTF-8.