Типы TRVSaveOption, TRVSaveOptions (устарели)

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

Типы TRVSaveOption, TRVSaveOptions (устарели)

Устарело. Используйте TRichView.HTMLSaveProperties.

Модуль [VCL/FMX]: RVStyle / fmxRVStyle.

type

  TRVSaveOption = (rvsoOverrideImages,

    rvsoFirstOnly, rvsoMiddleOnly, rvsoLastOnly,

    rvsoDefault0Style, rvsoNoHypertextImageBorders,

    rvsoImageSizes, rvsoForceNonTextCSS, rvsoUseCheckpointsNames,

    rvsoMarkersAsText, rvsoNoDefCSSStyle, rvsoInlineCSS,

    rvsoUseItemImageFileNames,

    rvsoXHTML, rvsoUTF8, rvsoHeaderFooter, rvsoInlineImages);

  TRVSaveOptions = set of TRVSaveOption;

Опции экспорта HTML. Используются в параметрах устаревших методов сохранения HTML: SaveHTML, SaveHTMLEx, SaveHTMLToStream, SaveHTMLToStreamEx.

Сохранение изображений, для SaveHTML и SaveHTMLEx

Опция

Описание

rvsoOverrideImages

Если включена, ТРВ-Редактор может перезаписывать существующие изображения.

rvsoNoHypertextImageBorders

Устарела, ничего не делает.

rvsoImageSizes

Если включена, ТРВ-Редактор явно сохраняет ширину и высоту изображений в HTML.

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

Эта опция не влияет на изображения, для которых заданы целочисленные свойства элемента rvepImageWidth и/или rvepImageHeight. Для таких изображений размеры сохраняются всегда.

Для конкретного элемента это поведение можно переопределить с помощью целочисленного свойства rveoNoHTMLImagesSize.

rvsoUseItemImageFileNames

Если включена, изображения с заданными непустыми именами файлов не сохраняются, но их имена файлов записываются в HTML. При этом в событиях OnHTMLSaveImage и OnSaveImage2 начальное значение параметра Location равно имени файла изображения.

Имена файлов изображений для элементов документа задаются строковым свойством rvespImageFileName.

rvsoInlineImages

Если эта опция включена, изображения сохраняются непосредственно в HTML в кодировке Base64 вместо внешних файлов.

Сохранение маркеров списка, для SaveHTML и SaveHTMLEx

Опция

Описание

rvsoMarkersAsText

Если эта опция включена, списки абзацев сохраняются как обычный текст или изображения. Обычно HTML-файлы, сохранённые с этой опцией, выглядят ближе к исходному документу.

Если эта опция не включена, списки сохраняются с помощью HTML-тегов <ul> и <ol>.

Если rvsoMarkersAsText не включено

Экспорт с использованием CSS (SaveHTMLEx); CSS списков вставляется непосредственно в HTML:

▪rvlstBullet, rvlstUnicodeBullet – экспортируются как маркированные списки со стандартными маркерами (disc, circle или square). FormatString и Font игнорируются;

▪rvlstDecimal, rvlstLowerAlpha, rvlstUpperAlpha, rvlstLowerRoman, rvlstUpperRoman и т.п. – экспортируются как списки с соответствующей нумерацией. FormatString и Font игнорируются;

▪rvlstPicture, rvlstImageList, rvlstImageListCounter – экспортируются как маркеры с изображениями. Способ сохранения изображений по умолчанию можно изменить с помощью OnHTMLSaveImage;

▪отступы сохраняются, но не очень точно.

Экспорт без CSS (SaveHTML):

▪rvlstBullet, rvlstUnicodeBullet, rvlstPicture, rvlstImageList – экспортируются как маркированные списки со стандартными маркерами (disc, circle или square). FormatString, Picture, ImageList и Font игнорируются;

▪rvlstDecimal, rvlstLowerAlpha, rvlstUpperAlpha, rvlstLowerRoman, rvlstUpperRoman – экспортируются как списки с соответствующей нумерацией. FormatString и Font игнорируются;

▪rvlstImageListCounter – сохраняется как десятичная нумерация;

▪отступы не сохраняются.

Если rvsoMarkersAsText включено

Маркеры сохраняются без специальных HTML-тегов списков, таких как <ol>, <ul> и <li>.

Настройки шрифта и строк формата учитываются.

При сохранении без CSS (SaveHTML) все отступы игнорируются.

При сохранении с CSS (SaveHTMLEx) сохраняются LeftIndent и MarkerIndent. FirstIndent сохраняется только для невисящих маркеров (MarkerIndent >= LeftIndent).

В целом HTML-файлы, сохранённые с этой опцией, обычно выглядят ближе к исходному документу.

Остальные опции, общие для SaveHTML и SaveHTMLEx

Опция

Описание

rvsoUseCheckpointsNames

Вместо номеров закладок используются их имена. Рекомендуется.

rvsoXHTML

Если включена, вместо HTML сохраняется XHTML.

rvsoUTF8

Если включена, HTML-файл сохраняется в Unicode (UTF-8). Настоятельно рекомендуется для многоязычных документов.

rvsoDefault0Style

Если включена, форматирование текста стиля с номером 0 (TextStyles[0]) не сохраняется.

Для такого текста браузеры будут использовать шрифт по умолчанию.

Эта опция влияет на внешний вид всех стилей, поскольку сохраняются только те атрибуты, которые отличаются от атрибутов стиля с номером 0.

rvsoHeaderFooter

Если включена, в начале HTML-документа сохраняется верхний колонтитул, а в конце - нижний колонтитул. Верхний и нижний колонтитулы задаются методами SetHeader / SetFooter.

Если DocParameters.TitlePage = True, компонент использует колонтитулы первой страницы. В противном случае используются обычные колонтитулы.

Для SaveHTMLEx колонтитулы всегда используют встроенный CSS, как если бы была включена опция rvsoInlineCSS.

Опции для SaveHTML

Опция

Описание

rvsoForceNonTextCSS

CSS используется при экспорте нетекстовых элементов. Эта опция позволяет сохранить цвета горизонтальных линий и свойства таблиц при сохранении с помощью SaveHTML без использования CSS для стилей текста и абзацев.

Примечание: SaveHTMLEx всегда использует CSS.

Опции для SaveHTMLEx

Опция

Описание

rvsoNoDefCSSStyle

По умолчанию SaveHTMLEx назначает атрибуты TextStyles[0] тегам <body> и <table>, а атрибуты всех остальных стилей сохраняются относительно атрибутов TextStyles[0].

Если включить эту опцию, TextStyles[0] будет обрабатываться так же, как любой другой стиль. То же самое относится к ParaStyles[0].

Использовать эту опцию не рекомендуется – она приводит к созданию значительно более объёмных CSS и HTML.

Эта опция полезна, если HTML, созданный ТРВ-Редактором, используется как часть более крупного HTML-документа и вы не хотите изменять свойства <body> и <table>.

rvsoInlineCSS

Если включена, CSS вставляется непосредственно в теги <p>, <span> и <li> вместо создания таблицы CSS в начале HTML.

Эта опция создаёт значительно более объёмный HTML. Не рекомендуется.

Сохранение части документа, для SaveHTML и SaveHTMLEx

Эти опции полезны при создании HTML-фрагментов, которые затем будут вставлены в более крупный HTML-документ.

Опция

Описание

rvsoFirstOnly

Если включена, сохраняется только начальная часть HTML-документа (включающая открывающий тег <html>, <head> и открывающий тег <body>)

rvsoMiddleOnly

Если включена, сохраняется только содержимое HTML-документа внутри тега <body>

rvsoLastOnly

Если включена, сохраняется только завершающую часть HTML-документа (закрывающие теги <body> и <html>)

Если ни одна из этих трёх опций не задана, сохраняется полный HTML-документ.

Нельзя одновременно включать две или все три опции – в этом случае ничего не будет сохранено.