TCustomRichView.LoadHTML

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

TCustomRichView.LoadHTML

Добавляет документ HTML из файла FileName в конец документа.

function LoadHTML(const FileName: TRVUnicodeString;

  CodePage: TRVCodePage = CP_ACP): Boolean;

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

Параметры:

FileName – имя HTML-файла.

CodePage задаёт кодировку HTML-файла. Если равен 0 (CP_ACP), кодировка распознаётся компонентом TRichView.

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

Параметры загрузки находятся в HTMLReadProperties.

См. важное примечание о загрузке внешних изображений из HTML.

По умолчанию цели гиперссылок загружаются в теги элементов документа. Это может быть настроено в событии OnReadHyperlink.

Определение кодировки

TRichView распознаёт кодировку HTML по метке порядка байтов Юникода (UTF-8, UTF-16 little endian, UTF-16 big endian) и по кодировке, указанной в HTML. Метки порядка байтов Юникода имеют более высокий приоритет, чем кодировка, указанная в HTML.

Без метки порядка байтов Юникода, TRichView не может распознать кодировку UTF-16, даже если она указана в HTML. Чтобы загрузить UTF-16 без метки порядка байтов, необходимо указать её в параметре CodePage этого метода:

▪1200 для UTF-16 little endian (формат Юникода по умолчанию в Windows)

▪1201 для UTF-16 big endian.

В качестве альтернативы можно использовать метод LoadFromFile, который может распознать и загружать HTML в кодировке UTF-16.

Шаблоны стилей

Если используются шаблоны стилей, и StyleTemplateInsertMode<>rvstimIgnoreSourceStyleTemplates, этот метод включает таблицу стилей из HTML в Style.StyleTemplates. Если TRichView был полностью пуст до загрузки, LoadHTML заменяет существующие шаблоны стилей. В противном случае он включает таблицу стилей HTML в существующие шаблоны стилей и считывает стили текста и абзацев в соответствии с StyleTemplateInsertMode. Метод вызывает событие OnStyleTemplatesChange.

Таблица стилей HTML создаётся на базе свойств, которые имеют определённые HTML-элементы после чтения открывающего тега элемента <body>.

Таблица ниже перечисляет HTML-элементы и соответствующие шаблоны стилей (StyleTemplates).

HTML-элемент

Имя шаблона стиля

Тип шаблона стиля

p

'Normal'

rvstkPara

h1..h6

'heading 1' .. 'heading 6'

rvstkParaText

pre

'HTML Preformatted'

address

'HTML Address'

blockquote

'Quote'

strong

'Strong'

rvstkText

em

'Emphasis'

a

'Hyperlink'

code

'HTML Code'

acronym

'HTML Acronym'

var

'HTML Variable'

kbd

'HTML Keyboard'

samp

'HTML Sample'

tt

'HTML Typewriter'

dfn

'HTML Definition'

cite

'HTML Cite'

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

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

 

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

▪LoadHTMLFromStream;

▪SaveHTML.

См. также события TRichView:

▪OnImportPicture;

▪OnImportFile;

▪OnReadHyperlink;

▪OnStyleTemplatesChange;

▪OnProgress;

▪OnAssignImageFileName.

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

▪InsertHTMLFromFileEd.

См. также:

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