TCustomRichView.LoadFromStream, LoadFromStreamEx

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

TCustomRichView.LoadFromStream, LoadFromStreamEx

Загружают документ из потока Stream, автоматически определяя его формат (RVF/RTF/HTML/DocX/Markdown/текст)

function LoadFromStream(Stream: TStream; IsTextUnicode: TRVYesNoAuto

  AllowMarkdown: Boolean = False; 

  const Path: TRVUnicodeString = '';

  CodePage: TRVCodePage = RV_CP_DEFAULT): Boolean;

function LoadFromStreamEx(Stream: TStream

  IsTextUnicode: TRVYesNoAuto; AllowedFormats: TRVLoadFormats;
  out Unicode: Boolean; out LoadedFormat: TRVLoadFormat;
  const Path: TRVUnicodeString = '';

  CodePage: TRVCodePage = RV_CP_DEFAULT): Boolean;): Boolean;

Эти методы могут определять как обычный RTF, так и RTF, преобразованный в юникодную строку (UTF-16).

HTML определяется наличием '<html' или '<head' в пределах первых 1024 символов.

Если поток не содержит RVF, RTF, HTML или DocX, то загружается текст или Markdown. Методы не загружают текст или Markdown, если поток содержит символы с кодами меньше ord(' ').

Path – это базовый путь для изображений, на которые могут ссылаться документы.

IsTextUnicode определяет, имеет ли текст/Markdown кодировку Юникод (UTF-16):

rvynaNo не Юникод (т.е., не UTF-16);

rvynaYes Юникод (UTF-16);

rvynaAuto автоматическое определение ANSI/Unicode (велика вероятность ошибки).

Если Юникод указан или обнаружен, текст или Markdown загружаются в кодировке UTF-16.

В противном случае текст и Markdown загружаются с использованием кодировки, указанной в параметре CodePage. Значение по умолчанию для CodePage = RV_CP_DEFAULT (что означает UTF-8 для Markdown, кодовую страницу ANSI по умолчанию для обычного текста в Windows, UTF-8 для обычного текста в других системах).

LoadFromStream: если AllowMarkdown = True, загружается Markdow; иначе загружается текст.

LoadFromStreamEx: допустимые форматы загрузки перечислены в AllowedFormats. Если этот параметр содержит и rvlfText и rvlfMarkdown, загружается Markdown. Загруженный формат возвращается в параметре LoadedFormat. Если загруженный текст/markdown/HTML/RTF хранился в кодировках UTF-16 или UTF-8, параметру Unicode присваивается значение True .

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

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

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

 

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

LoadFromFile, LoadFromFileEx

LoadRVFFromStream;

LoadRTFFromStream;

LoadDocXFromStream;

LoadMarkdownFromStream;

LoadHTMLFromStream;

LoadTextFromStream, LoadTextFromStreamW.