rvico TRichView Reference | TRichView

TCustomRichView.Options

Top  Previous  Next

Options

type

  TRVOption = (rvoAllowSelection, rvoSingleClick, rvoScrollToEnd,

    rvoClientTextWidth, 

    rvoShowCheckpoints, rvoShowPageBreaks,rvoShowSpecialCharacters,

    rvoTagsArePChars,

    rvoAutoCopyText,  rvoAutoCopyUnicodeText

    rvoAutoCopyRVF, rvoAutoCopyImage,

    rvoAutoCopyRTF,

    rvoFormatInvalidate,

    rvoDblClickSelectsWord, rvoRClickDeselects,

    rvoDisallowDrag, rvoShowItemHints, rvoFastFormatting);

  TRVOptions = set of TRVOption;

 

property Options: TRVOptions;

Note: TRVOption and TRVOptions are declared in RVScroll unit.

Default value

[rvoAllowSelection, rvoScrollToEnd, rvoAutoCopyText, rvoAutoCopyImage, rvoAutoCopyRVF, rvoAutoCopyRTF, rvoDblClickSelectsWord, rvoRClickDeselects, rvoFormatInvalidate, rvoShowPageBreaks, rvoFastFormatting]

General Options

Option

Meaning

rvoTagsArePChars

If cleared (default), items tags are treated as integer values.

If set, items tags are treated as pointers to dynamically allocated strings. See details

Can be changed: when document is empty or does not contain nonzero tags.

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

 

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 vertical 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.

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.

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.

 

Clipboard Options (See Details)

If set , RichView copies selection to the Clipboard in the specified format when user presses  Ctrl + Insert  or  Ctrl + C . These options also affect CopyDef. These options can be changed any time.

Option

Format to Copy

rvoAutoCopyText

ANSI text

rvoAutoCopyUnicodeText

Unicode text

rvoAutoCopyRVF

RVF (RichView Format)

rvoAutoCopyRTF

RTF (Rich Text Format)

rvoAutoCopyImage

Bitmap or metafile (if the image is selected)


RichView © Sergey Tkachenko