<< Click to display table of contents >>


Options for reading and saving RVF (RichView Format)


  TRVFOption = 

    (rvfoSavePicturesBody, rvfoSaveControlsBody,

    rvfoIgnoreUnknownPicFmt, rvfoIgnoreUnknownCtrls,






    rvfoSaveBack, rvfoLoadBack,

    rvfoSaveTextStyles, rvfoSaveParaStyles,

    rvfoSaveLayout, rvfoLoadLayout,

    rvfoSaveDocProperties, rvfoLoadDocProperties,

    rvfoCanChangeUnits, rvfoSaveStyleTemplatesOnlyNames,

    rvfoSaveDocObjects, rvfoLoadDocObjects,


  TRVFOptions = set of TRVFOption;


property RVFOptions: TRVFOptions;

Note: TRVFOption and TRVFOptions are defined in RVStyle unit.

Options for Saving




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

If not set, OnRVFPictureNeeded event occurs on loading.


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

If not set, OnRVFControlNeeded event occurs loading.


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.


(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)


(almost obsolete)

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


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


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.


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

See RVFTextStylesReadMode property.

This option affects saving style templates.*


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.

This option affects saving style templates.*


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)


If set, DocProperties and DocParameters are saved in RVF.

(see rvfoLoadDocProperties below)


If set, when style templates must be saved in RVF*, only their names are saved. When loading such files, existing style templates are applied to loaded text and paragraph styles. This option is useful if you want to create multiple documents using the same collection of style templates. Since style templates are not saved in RVF in this mode, an application must save them itself elsewhere.


If set, DocObjects are saved in RVF.

(see rvfoLoadDocObjects below)

* If the both rvfoSaveTextStyles and rvfoSaveParaStyles are included, and UseStyleTemplates=True, Style.StyleTemplates are saved as well.

Options for Loading




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

(see rvfoSaveBack above)


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

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


The same as rvfoIgnoreUnknownPicFmt, but for controls


If set, TRichView ignores errors occurred while reading inserted controls


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.


If set, TRichView 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.


If not set, TRichView ignores layout information saved in RVF

(see rvfoSaveLayout above)


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

(see rvfoSaveDocProperties above)


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.


If set, DocObjects are loaded from RVF.

(see rvfoSaveDocObjects above)


If set, names of graphic classes specified in RVF are ignored. File format is determined by content, and the default graphic class for this file format is used (see TRVGraphicHandler)

If not set, the component tries to use a graphic class specified in RVF. If this class is not found, TRichView works as if this option is specified.

The procedure described above is used for graphic items (pictures and hot pictures), background images of tables and table cells. For pictures of list markers, the specified graphic class is always used.

See RVF Overview for details.

Default value:

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

Default value for components, placed on form at design time (can be changed in TRichView component editor):

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

See also: