|
<< Нажмите, чтобы показать Содержание >> 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];
См. также: