rvico TRichView Reference | TRichView

TCustomRichView.RTFOptions

Top  Previous  Next

Options for saving RTF (Rich Text Format).

type

  TRVRTFOption = (rvrtfSaveStyleSheet,

    rvrtfDuplicateUnicode, rvrtfSaveEMFAsWMF,

    rvrtfSaveJpegAsJpeg, rvrtfSaveBitmapDefault,

    rvrtfSaveEMFDefault, rvrtfSavePicturesBinary,

    rvrtfPNGInsteadOfBitmap,

    rvrtfSaveDocParameters, rvrtfSaveHeaderFooter);

  TRVRTFOptions = set of TRVRTFOption;

 

property RTFOptions: TRVRTFOptions;

(introduced in versions 1.3, 10, 11)

Note: TRVRTFOption and TRVRTFOptions are declared in RVStyle unit.

Option

Meaning

rvrtfSaveStyleSheet

If set (not recommended), RichView saves style sheet in RTF.

Usually it's not needed, many RTF readers just skip style sheet.

rvrtfDuplicateUnicode

If set, RichView saves ANSI equivalent of Unicode text.

Conversion is based on Charset property of text styles.

Turning off this option causes speed up and generates much smaller RTF file.

Unicode-enabled RTF readers just ignore ANSI equivalent of Unicode characters.

rvrtfSaveEMFAsWMF

If set, RichView saves EMF (enhanced (Win32) metafiles) as WMF (Windows (Win3.1) metafiles).

Some RTF readers do not understand EMF in RTF.

rvrtfSaveJpegAsJpeg

If set, RichView saves Jpegs (Delphi 3+ required) as Jpegs.

Some RTF readers do not understand Jpegs in RTF.

Otherwise, RichView saves Jpegs in other formats (see below).

rvrtfSaveBitmapDefault

If set, RichView saves graphics formats other than bitmaps, metafiles (and optionally Jpegs) as bitmaps. If not set, as WMF or EMF (see below). See also rvrtfPNGInsteadOfBitmap below.

(unfortunately, many RTF reader do not understand WMF with mapping mode = MM_TEXT, which RichView uses for saving other formats; some other RTF readers do not understand bitmaps).

rvrtfSaveEMFDefault

If set (and rvrtfSaveBitmapDefault is not set), RichView saves graphics formats other than bitmaps (and optionally Jpegs) as EMF. If not set, as WMF

rvrtfSavePicturesBinary

If set, pictures are saved in binary format. Less in size (twice), but such RTF becomes a binary file (and cannot be stored in MEMO field of data bases)

rvrtfPNGInsteadOfBitmap

If included, and PNG class is registered with RV_RegisterPngGraphic, bitmaps are saved as PNG (including saving of non-RTF picture types, if rvrtfSaveBitmapDefault is included). Not all RTF readers understand PNG.

rvrtfSaveDocParameters

If included, properties of DocParameters are saved in RTF.

rvrtfSaveHeaderFooter

If included, documents assigned by RTFReadProperties.SetHeader and .SetFooter are saved as a header and footer in RTF. Affects only SaveRTF method (not SaveRTFToStream).

Default value

[rvrtfDuplicateUnicode, rvrtfSaveEMFAsWMF, rvrtfSaveJpegAsJpeg]

See also methods:

SaveRTF;

SaveRTFToStream;

CopyRTF.

See also:

Saving and loading in RichView;

Pictures.


RichView © Sergey Tkachenko