|
<< Нажмите, чтобы показать Содержание >> 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 – номер стиля абзаца, который будет применён к добавляемому тексту. Он задаёт атрибуты добавляемых абзацев.
AsSingleParagraph (и DefAsSingleParagraph):
▪False – методы используют текущий режим добавления абзацев (см. SetAddParagraphMode);
▪True – методы добавляют текст как один абзац (добавляют первую строку в текущем режиме добавления абзацев, устанавливают режим добавления абзацев в False, добавляют остальные строки, восстанавливают прежний режим добавления абзацев). DefAsSingleParagraph влияет только на обработку символов CR и LF. Символ WideChar($2029) (разделитель абзацев) всегда добавляет абзац. Символ WideChar($2028) (разделитель строк) всегда добавляет новую строку.
CodePage – кодировка для преобразования текста из файла в Юникод.
LoadTextW поддерживает маркеры порядка байтов (если маркер есть, он должен быть первым символом в файле).
Тип метода:
быстрое изменение документа.
Если используются шаблоны стилей, компонент может автоматически изменять номера стилей текста для обеспечения согласованности шаблонов стилей текста и абзаца.
Возвращаемое значение:
«Было ли чтение успешным?»
См. также методы:
▪LoadTextFromStream, LoadTextFromStreamW;
▪Format;
См. также методы TRichViewEdit:
▪InsertTextFromFile, InsertTextFromFileW.
См. также свойства TRVStyle:
См. также: