TCustomRichView.RVFOptions

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

TCustomRichView.RVFOptions

Опции для сохранения и загрузки документов в формате RVF (RichView Format). Некоторые опции также влияют на сохранение и загрузку файлов XML компонентом РВ-XML (TRichViewXML).

type

  TRVFOption = 

    (rvfoSavePicturesBody, rvfoSaveControlsBody,

    rvfoIgnoreUnknownPicFmt, rvfoIgnoreUnknownCtrls,

    rvfoIgnoreUnknownCtrlProperties

    rvfoConvUnknownStylesToZero,

    rvfoConvLargeImageIdxToZero,

    rvfoSaveBinary,

    rvfoUseStyleNames,

    rvfoSaveBack, rvfoLoadBack,

    rvfoSaveTextStyles, rvfoSaveParaStyles,

    rvfoSaveLayout, rvfoLoadLayout,

    rvfoSaveDocProperties, rvfoLoadDocProperties,

    rvfoCanChangeUnits, rvfoSaveStyleTemplatesOnlyNames,

    rvfoSaveDocObjects, rvfoLoadDocObjects,

    rvfoIgnoreGraphicClasses);

  TRVFOptions = set of TRVFOption;

 

property RVFOptions: TRVFOptions;

Примечание: TRVFOption и TRVFOptions объявлены в модуле RVStyle/fmxRVStyle.

Сохранение

Опция

Описание

rvfoSavePicturesBody

Если включена, содержимое изображений в документе TRichView сохраняется в RVF.

Иначе, событие OnRVFPictureNeeded происходит при загрузке.

rvfoSaveControlsBody

Если включена, содержимое компонентов в документе TRichView сохраняется в RVF.

Иначе, событие OnRVFControlNeeded происходит при загрузке.

rvfoSaveBinary

Если включена, все нетекстовые данные сохраняются в RVF в бинарном формате (рисунки, компоненты, таблицы, фон, стили, юникодный текст).

Иначе, все бинарные данные сохраняются как текст (шестнадцатеричные строки); RVF становится текстовыми форматом, подобно RTF, но размер файла увеличивается.

rvfoSaveBack

Если включена, фон документа сохраняется RVF.

Эта опция влияет только на сохранение всего документа; выделенный фрагмент никогда не сохраняется (и не копируется в буфер обмена) с фоном.

(см. rvfoLoadBack ниже)

rvfoUseStyleNames

(почти устарела)

Если включена, TRichView сохраняет названия стилей в RVF вместо их номеров.

Плюсы:

содержимое RVF и TRichView можно синхронизировать, даже если некоторые стили были удалены или вставлены;

Минусы:

больший размер файла;

имена стилей не должны повторяться;

файл становится чувствительным к изменению имён стилей.

Не рекомендуется использовать эту опцию совместно с rvfoSaveTextStyles и rvfoSaveParaStyles.

rvfoSaveTextStyles

Если включена, коллекция стилей текста, связанная с документом в TRichView (свойство TextStyles связанного компонента TRVStyle) сохраняется в RVF.

См. свойство RVFTextStylesReadMode.

Эта опция влияет на сохранение шаблонов стилей.*

rvfoSaveParaStyles

Если включена, коллекции стилей абзацев и списков, связанные с документом в TRichView (свойства ParaStyles и ListStyles связанного компонента TRVStyle) сохраняются в RVF.

См. свойство RVFParaStylesReadMode.

Эта опция влияет на сохранение шаблонов стилей.*

rvfoSaveLayout

Если включена, следующие свойства сохраняются в RVF:

Left-, Right-, Top-, BottomMargin, MinTextWidth, MaxTextWidth, BiDiMode.

Они сохраняются только с полным документом (не выделенным фрагментом).

(см. rvfoLoadLayout ниже)

rvfoSaveDocProperties

Если включена, DocProperties и DocParameters сохраняются в RVF.

(см. rvfoLoadDocProperties ниже)

rvfoSaveStyleTemplatesOnlyNames**

Если включена, если шаблоны стилей должны быть сохранены в RVF*, сохраняются только их имена. При загрузке таких файлов существующие шаблоны стилей применяются к загруженным стилям текста и абзацев. Эта опция полезна, если вы хотите сохранить несколько документов, имеющих общую коллекцию шаблонов стилей. Так как сами шаблоны стилей не сохраняются в RVF в этом режиме, вам нужно будет сохранить их отдельно.

rvfoSaveDocObjects

Если включена, коллекция DocObjects сохраняется в RVF.

(см. rvfoLoadDocObjects ниже)

* если обе опции rvfoSaveTextStyles и rvfoSaveParaStyles включены, и UseStyleTemplates=True, Style.StyleTemplates также сохраняются.

** эта опция также используется компонентом TRichViewXML при сохранении файлов XML.

Загрузка

Опция

Описание

rvfoLoadBack

Если не включена, TRichView игнорирует информацию о фоне, сохранённую в RVF.

(см. rvfoSaveBack выше)

rvfoIgnoreUnknownPicFmt**

Если включена, TRichView пропускает картинки неопределённого формата (графику незарегистрированных классов и форматов, которые нельзя определить по содержимому).

Иначе, методы чтения RVF возвращают False (признак ошибки) в таких случаях.

rvfoIgnoreUnknownCtrls**

То же что rvfoIgnoreUnknownPicFmt, но для компонентов.

rvfoIgnoreUnknownCtrlProperties

Если включена, TRichView игнорирует ошибки, происходящие при чтении свойств компонентов.

rvfoConvLargeImageIdxToZero**

Если включена, слишком большие (>=Imagelist.Count) номера индексов изображений для обычных и интерактивных значков преобразуются в 0.

Иначе, методы чтения RVF возвращают False (признак ошибки) в таких случаях.

rvfoConvUnknownStylesToZero**

Если включена, TRichView преобразует слишком большие (>= RichView.Style.TextStyles.Count, или RichView.Style.ParaStyles.Count) номера стилей в 0.

Иначе, методы чтения RVF возвращают False (признак ошибки) в таких случаях.

rvfoLoadLayout

Если включена, TRichView читает информацию о свойствах разметки из RVF

(см. rvfoSaveLayout выше)

rvfoLoadDocProperties

Если включена, DocProperties и DocParameters загружаются из RVF (но только не методами для вставки RVF)

(см. rvfoSaveDocProperties выше)

rvfoCanChangeUnits

Если включена, компонент может установить свойство Style.Units в значение, прочитанное из RVF. Такое изменение возможно только если RVF загружается, а не вставляется.

rvfoLoadDocObjects

Если включена, коллекция DocObjects загружается из RVF.

(см. rvfoSaveDocObjects выше)

rvfoIgnoreGraphicClasses**

Если включена, имена графических классов, содержащиеся в RVF, игнорируются. Формат графики определяется по её содержимому, и используется класс по умолчанию для этого формата (см. TRVGraphicHandler)

Иначе, компонент пытается использовать графический класс, указанный в RVF. Если этот класс не найден, TRichView работает так, как если бы эта опция включена.

Процедура, описанная выше, используется для рисунков (обычных и интерактивных), фоновых изображений таблиц и ячеек таблиц. Для изображений маркеров списков всегда используются указанные графические классы.

** эта опция также используется компонентом TRichViewXML при загрузке файлов XML.

См. Обзор RVF для получения подробной информации.

Значение по умолчанию (VCL и LCL):

[rvfoSavePicturesBody, rvfoSaveControlsBody, rvfoSaveBinary, rvfoSaveDocProperties, rvfoLoadDocProperties, rvfoSaveDocObjects, rvfoLoadDocObjects];

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

[rvfoSavePicturesBody, rvfoSaveControlsBody, rvfoSaveBinary, rvfoSaveDocProperties, rvfoLoadDocProperties, rvfoSaveTextStyles, rvfoSaveParaStyles, rvfoSaveDocObjects, rvfoLoadDocObjects];

Значение по умолчанию для компонентов, помещённых на форму в режиме проектирования (designtime) (может быть изменено в редакторе компонента TRichView):

[rvfoSavePicturesBody, rvfoSaveControlsBody, rvfoSaveBinary, rvfoSaveDocProperties, rvfoLoadDocProperties, rvfoSaveTextStyles, rvfoSaveParaStyles, rvfoSaveDocObjects, rvfoLoadDocObjects];

См. также:

RVFWarnings