|
Options for reading and saving RVF (RichView Format)
type
TRVFOption =
(rvfoSavePicturesBody, rvfoSaveControlsBody,
rvfoIgnoreUnknownPicFmt, rvfoIgnoreUnknownCtrls,
rvfoConvUnknownStylesToZero,
rvfoConvLargeImageIdxToZero,
rvfoSaveBinary,
rvfoUseStyleNames,
rvfoSaveBack, rvfoLoadBack,
rvfoSaveTextStyles, rvfoSaveParaStyles,
rvfoSaveLayout, rvfoLoadLayout,
rvfoSaveDocProperties, rvfoLoadDocProperties);
TRVFOptions = set of TRVFOption;
property RVFOptions: TRVFOptions;
Note: TRVFOption and TRVFOptions are defined in RVStyle unit.
Options for Saving
Option
|
Meaning
|
rvfoSavePicturesBody
|
| ▪ | If set, full information about all pictures in RichView are saved in RVF. |
|
rvfoSaveControlsBody
|
| ▪ | If set, full information about all controls in RichView are saved in RVF. |
|
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 (requires Delphi3+)
Pluses:
| ▪ | content of file remains synchronized with collections of styles even if you delete or insert new styles; |
Minuses:
| ▪ | 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)
|
Options for Loading
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
|
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)
|
See RVF Overview for details.
Default value:
[rvfoSavePicturesBody, rvfoSaveControlsBody, rvfoSaveBinary, rvfoSaveDocProperties, rvfoLoadDocProperties];
Default value for components, placed on form at design time (can be changed in TRichView component editor):
[rvfoSavePicturesBody, rvfoSaveControlsBody, rvfoSaveBinary, rvfoSaveDocProperties, rvfoLoadDocProperties, rvfoSaveTextStyles, rvfoSaveParaStyles];
|