TCustomRichView.Options

<< Click to display table of contents >>

TCustomRichView.Options

Options

type

  TRVOption = (rvoAllowSelection, rvoSingleClick, rvoScrollToEnd,

    rvoClientTextWidth, 

    rvoShowCheckpoints, rvoShowPageBreaks,

    rvoShowSpecialCharacters, rvoShowHiddenText,

    rvoTagsArePChars,

    rvoAutoCopyText,  rvoAutoCopyUnicodeText

    rvoAutoCopyRVF, rvoAutoCopyImage,

    rvoAutoCopyRTF,

    rvoFormatInvalidate,

    rvoDblClickSelectsWord, rvoRClickDeselects,

    rvoDisallowDrag, rvoShowItemHints, rvoShowGridLines,

    rvoFastFormatting, rvoPercentEncodedURL, rvoAssignImageFileNames,

    rvoDefaultSelectionFill* 

  TRVOptions = set of TRVOption;

 

property Options: TRVOptions;

Note: TRVOption and TRVOptions are declared in RVScroll/fmxRVScroll unit.

Note*: this option is defined only for FireMonkey

Default value

For VCL and LCL Delphi/C++Builder 2009 or newer: [rvoAllowSelection, rvoScrollToEnd, rvoAutoCopyUnicodeText, rvoAutoCopyImage, rvoAutoCopyRVF, rvoAutoCopyRTF, rvoDblClickSelectsWord, rvoRClickDeselects, rvoFormatInvalidate, rvoShowPageBreaks, rvoShowGridLines, rvoFastFormatting]

Fore FireMonkey: the same + rvoDefaultSelectionFill.

For older versions: the same, but with rvoAutoCopyText instead of rvoAutoCopyUnicodeText.

General Options

Option

Meaning

rvoTagsArePChars

Obsolete, does nothing.

rvoClientTextWidth

If set, text always wraps to fit client width of RichView.

Also affects breaks and tables.

See details.

Can be changed: any time, but you need to reformat and repaint RichView after changing this option, if the document was already formatted.

rvoScrollToEnd

If set (default), RichView scrolls to the end of document when FormatTail method is called.

If cleared, document does not scroll in this case

Can be changed: any time.

rvoSingleClick

If set, OnRVDblClick event is generated on single mouse click

If cleared (default), it is generated on double mouse click

Can be changed: any time.

rvoFormatInvalidate

If set (default), Format and FormatTail methods repaint component.

Can be changed: any time.

rvoDisallowDrag

If set, dragging from this TRichView is not allowed.

Can be changed: any time.

rvoFastFormatting

Increase performance in WinNT-based OS at the cost of some resources

rvoPercentEncodedURL

If set, it is assumed that URLs (stored in tags or provided in OnWriteHyperlink event) are %-encoded, so no additional encoding/decoding is necessary when working with RTF, HTML, and DocX.

By default (if not set), the component %-encodes hyperlink targets saved to RTF, HTML, DocX, and %-decodes when loading RTF.

rvoAssignImageFileNames

If set, the component assigns file names of images, when possible.

This option affects: RTF loading (reading external images), HTML loading (using importer components), pasting files, accepting files and links to images as a result of drag&drop, RichViewActions (actions for inserting images and assigning background images of tables).

The following properties are set:

table.BackgroundImageFileName

cell.BackgroundImageFileName

rvespImageFileName item property

See also: OnAssignImageFileName event.

 

Selection Options

Can be changed: any time.

Option

Meaning

rvoAllowSelection

If set (default), user can select content of RichView using mouse or keyboard.

Please do not clear this option for TRichViewEditor!

See: working with selection.

rvoDblClickSelectsWord

If set (default), double click on word selects it (and double click on non-text item selects this item)

rvoRClickDeselects

If set (default), right click outside the selected area deselects (and moves caret to the clicked position in TRichViewEdit)

 

Show/Hide Options

Option

Meaning

rvoShowCheckpoints

If set, all checkpoints are shown (as dotted horizontal lines, or by OnDrawCheckpoint). See details.

Can be changed: any time, you need to repaint RichView after changing this option

rvoShowPageBreaks

If set (default), page breaks are shown as horizontal lines.

Can be changed: any time, you need to repaint RichView after changing this option

rvoShowSpecialCharacters

If set, nonprinting characters are displayed as special marks: spaces, nonbreaking spaces, paragraph breaks, line breaks, tabs, soft hyphens in Unicode text, lines to left- and right-aligned items, places of insertion of text boxes.

Can be changed: any time, you need to reformat RichView after changing this option, if the document is already formatted.

See also: RVVisibleSpecialCharacters, RichViewShowGhostSpaces typed constants.

rvoShowHiddenText

If set, hidden items are displayed.

Can be changed: any time, you need to reformat RichView after changing this option, if the document is already formatted.

rvoShowItemHints

If set, items' hints are shown. Popup hints are shown only if ShowHints property is set to True. See item properties and OnItemHint event.

rvoShowGridLines

If set, table grid lines are shown.

 

Clipboard Options (See Details)

[VCL, LCL, FMX for Windows and macOS]: If set , TRichView copies the selection to the Clipboard in the specified formats when the user presses  Ctrl + Insert  or  Ctrl + C . These options also affect CopyDef. These options can be changed at any time.

[FMX for all platforms except for Windows and macOS]: the most appropriate format is chosen when copying.

Option

Format to Copy

rvoAutoCopyText

ANSI text (only for VCL and LCL)

rvoAutoCopyUnicodeText

Unicode text

rvoAutoCopyRVF

RVF (RichView Format)

rvoAutoCopyRTF

RTF (Rich Text Format)

rvoAutoCopyImage

Bitmap or metafile (if the image is selected)

FireMonkey-specific Options

Option

Format to Copy

rvoDefaultSelectionFill

If set, and if 'selection' brush resource can be found in the linked visual style (specified in StyleLookup property), SelColor, SelOpacity, InactiveSelColor properties of the linked TRVStyle component are updated according to this resource.