TCustomRichView.RVFOptions

Option

Meaning

rvfoSavePicturesBody

▪If set, full information about all pictures in RichView are saved in RVF.

▪If not set, OnRVFPictureNeeded event occurs on loading.

rvfoSaveControlsBody

▪If set, full information about all controls in RichView are saved in RVF.

▪If not set, OnRVFControlNeeded event occurs loading.

rvfoSaveBinary

▪If set, all non-text data are saved in RVF as they are (pictures, controls, tables, background, styles, Unicode text).

▪If not set, all binary data are converted to text (hexadecimal string); RVF becomes a plain text format, like RTF, but file size is increased.

rvfoSaveBack

(since version 1.2)

If set, background (color and image) is saved in RVF.

This flag affects only saving the whole document; selection is never saved (or copied to the Clipboard) with background.

(see rvfoLoadBack below)

rvfoUseStyleNames

(almost obsolete)

If set, TRichView saves quoted names of text and paragraph styles instead of their indices

Pluses:

▪content of file remains synchronized with collections of styles even if you delete or insert new styles;

Minuses:

▪increased file size;

▪names of styles must be unique;

▪files become sensitive to changing style names.

It's not recommended to use this options together with rvfoSaveTextStyles and rvfoSaveParaStyles.

rvfoSaveTextStyles

If set, collection of text styles associated with this RichView (TextStyles property of the linked TRVStyle component) is saved in RVF.

See RVFTextStylesReadMode property.

rvfoSaveParaStyles

If set, collections of paragraph and list styles associated with this RichView  (ParaStyles and ListStyles properties of the linked TRVStyle component)  are saved in RVF.

See RVFParaStylesReadMode property.

rvfoSaveLayout

If set, the following properties are stored in RVF:

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

Layout is saved only when saving the whole document (not selection).

(see rvfoLoadLayout below)

rvfoSaveDocProperties

If set, DocProperties and DocParameters are saved in RVF.

(see rvfoLoadDocProperties below)

Option

Meaning

rvfoLoadBack

If not set, RichView ignores background information, saved in RVF.

(see rvfoSaveBack above)

rvfoIgnoreUnknownPicFmt

▪If set, RichView skips pictures of unknown (unregistered) classes.

▪if not set, RVF reading methods return False (failure value) if pictures of unknown classes exist in RVF

rvfoIgnoreUnknownCtrls

The same as rvfoIgnoreUnknownPicFmt, but for controls

rvfoIgnoreUnknownCtrlProperties

If set, RichView ignores errors occurred while reading inserted controls

rvfoConvLargeImageIdxToZero

▪If set, too large (>=Imagelist.Count) image indices for bullets and hotspots are converted to 0.

▪if not set, RVF reading methods return False (failure value) in such case.

rvfoConvUnknownStylesToZero

▪If set, RichView converts too large (>= RichView.Style.TextStyles.Count, or RichView.Style.ParaStyles.Count) style indices to 0.

▪If not set, RVF reading methods return False (failure value) in such case.

rvfoLoadLayout

If not set, RichView ignores layout information saved in RVF

(see rvfoSaveLayout above)

rvfoLoadDocProperties

If set, DocProperties and DocParameters are loaded from RVF (but not by methods for RVF insertion)

(see rvfoSaveDocProperties above)

rvfoCanChangeUnits

If set, the component can change Style.Units to the value read from RVF. This change is possible only when RVF is loaded, not inserted.