TRVHTMLSaveProperties.ImageOptions

Опции для сохранения HTML.

type

  // Объявлено в модуле RVStyle/fmxRVStyle
  TRVHTMLSaveImageOption = (
    rvhtmlsioInlineImages,
    rvhtmlsioUseItemImageFileNames,
    rvhtmlsioImageSizes,

rvhtmlsioImageSizeAttributes,
rvhtmlsioOverrideImages,

    rvhtmlsioSuppressLinkUnderline
    );
  TRVHTMLSaveImageOptions =
    set of TRVHTMLSaveImageOption;

property ImageOptions: TRVHTMLSaveImageOptions;

Опция	Описание
rvhtmlsioInlineImages	Если включена, изображения сохраняются непосредственно в HTML-код (закодированные в base64). Если не включена, изображения сохраняются во внешних файлах.
rvhtmlsioUseItemImageFileNames	Если включена, изображения с заданными (не пустыми) именами файлов не будут сохранены, но их имена файлов будут записаны в HTML. Имена файлов для элементов задаются в строковом свойстве rvespImageFileName. Эта опция имеет более высокий приоритет, чем rvhtmlsioInlineImages. См. разъяснения под таблицей.
rvhtmlsioImageSizes	Если включена, TRichView всегда сохраняет размеры изображений в HTML, даже если их размеры не были изменены. Эта опция не влияет на изображения, у которых размер задан в дополнительных целочисленных свойствах rvepImageWidth и rvepImageHeight. Размеры всегда сохраняются для таких изображений. Опция может быть отключена для конкретного рисунка с помощью дополнительного целочисленного свойства rveoNoHTMLImagesSize.
rvhtmlsioImageSizeAttributes*	Если включена, размеры изображения всегда записываются как атрибуты HTML-элемента <img>, а не как свойства CSS.
rvhtmlsioOverrideImages	Эта опция используется, если изображения сохраняются во внешних файлах (т.е., rvhtmlsioInlineImages не включена). Если включена, TRichView может перезаписывать существующие файлы. Если не включена, TRichView генерирует уникальные имена файлов изображений.
rvhtmlsioSuppressLinkUnderline*	Если включена, подчёркивание гиперссылок под изображениями и другими нетекстовыми объектами будут явно отключены. Опция работает, только если HTMLSavingType = rvhtmlstNormal.

* Эти параметры полезны при сохранении HTML, который будет использоваться для создания электронного письма, открываемого в Microsoft Outlook. Они не требуются, если HTML-код будет сохраняться для просмотра в современных браузерах.

Когда TRichView сохраняет изображение в формате HTML, выполняются следующие действия:

1.Вызывается событие OnHTMLSaveImage. Если опция rvhtmlsioUseItemImageFileNames включена, строковое свойство rvespImageFileName используется как начальное значения для задания расположения изображения.
Если изображение не сохранено в обработчике этого события, то

2.Если опция rvhtmlsioUseItemImageFileNames включена, и значение строкового свойства rvespImageFileName не пустое, оно записывается в HTML; файл изображения не сохраняется.
Иначе

3.Вызывается событие OnSaveImage2.
Если изображение не сохранено в обработчике этого события, то

4.Если опция rvhtmlsioInlineImages включена, изображение сохраняется непосредственно в HTML-код (в кодировке base64).
Иначе

5.Изображение сохраняется в внешнем файле. Имя файла генерируется с учетом опции rvhtmlsioOverrideImages и свойства ImagesPrefix.

На двух последних этапах изображения, не имеющие веб-формат (например, значки или метафайлы), сохраняются в формате JPEG.

Значение по умолчанию:

▪для TRichView, TRichViewEdit, TDBRichView: []

▪для TDBRichViewEdit, TcxTRichViewEdit.Properties: [rvhtmlsioInlineImages]

См. также

▪TRVMarkdownProperties.SaveOptions (включает аналогичные опции для Markdown)