TRichView: Component editor

TRichView Component Editor

Top Previous Next

Component editor for TCustomRichView
(and all inherited components: TRichView, TRichViewEdit, TDBRichView, TDBRichViewEdit).

To display the component editor dialog in Delphi (C++Builder) IDE, right click RichView object on the form, choose "Settings" in the popup menu.

The dialog consists of 3 pages: Styles, Tags, RVF.

Styles

This page allows to select one of two style modes:

▪	Use a predefined set of styles.

▪	Allow adding styles dynamically.

This setting changes the properties: RVFTextStylesReadMode, RVFParaStylesReadMode, RVFOptions, RTFReadProperties.TextStyleMode, .ParaStyleMode. Changes are shown in the light yellow box below.

"Use a predefined set of styles" mode

In this mode, the component:

▪	does not add new items in the collection of text, paragraph and list styles of the linked TRVStyle component;

▪	does not save these styles in RVF files or streams.

"Allow adding styles dynamically" mode

In this mode, the component:

▪	adds new items in the collection of text, paragraph and list styles, if necessary; new styles can be added as a result of RVF and RTF loading;

▪	saves these styles in RVF files and streams.

If you want to display RTF files close to the original, or use commands for adding styles (for example, inside OnStyleConversion or OnParaStyleConversion, or RichViewActions), you must set this mode.

Since version 1.8, "Allow adding styles dynamically" is set by default for all new TRichViews created at design time (placed on forms from the Component Palette), if the defaults were not overridden.

Tags

This page allows to set one of two tag modes:

▪	Tags store integers.

▪	Tags store string.

This setting includes or excludes rvoTagsArePChars in Options.

"Tags store integers" mode

In this mode, tags (4-byte values associated with each document item) are treated as integer values.

"Tags store strings" mode

In this mode, tags are treated as pointers to dynamically allocated strings.

Typical using of tags - storing hyperlink targets. If you want to store target URLs in tags, use this mode.

RVF

Defines options for saving and loading RVF (RichView Format) files and strings. These settings change RVFOptions.

Storing The Component Editor's Options

Set "Default" checkbox to store settings on the given page. Settings are stored in the Registry. They will be applied to new components created in Delphi/C++Builder IDE from the Component Palette. Stored settings do not affect component creation at run time (from your code), and components that already were added on forms.