TCustomRichViewEdit.EditorOptions

<< Click to display table of contents >>

TCustomRichViewEdit.EditorOptions

Additional options affecting editing

type

  TRVEditorOption = (rvoClearTagOnStyleApp, rvoCtrlJumps,

    rvoDoNotWantReturns, rvoWantTabs,

    rvoAutoSwitchLang, rvoHideReadOnlyCaret, 

    rvoDoNotWantShiftReturns, rvoNoImageResize,

    rvoNoCaretHighlightJumps, rvoNoReadOnlyJumps,

    rvoDragDropPicturesFromLinks, rvoAlt0CodesUseKeyboardCodepage,

    rvoFastDeleteProtectedText);

  TRVEditorOptions = set of TRVEditorOption;

 

property EditorOptions: TRVEditorOptions;

Options for disabling/enabling certain editing operations

Option

Meaning

rvoDoNotWantReturns

If set, editor ignores  Enter  keys.

rvoDoNotWantShiftReturns

If set,  Shift + Enter  does nothing (by default, it inserts a line break inside paragraph noticeable in paragraphs with bullets or borders)

rvoWantTabs

If set (default), editor accepts  Tab  key ( Ctrl + Tab  always works). Tabs can be inserted as several spaces, or as a tabulator (special item type), depending on the value of SpacesInTab property of the linked TRVStyle component.

rvoNoImageResize

Prevents resizing pictures and controls with mouse.

rvoAlt0CodesUseKeyboardCodepage

 

If not set (default), users can hold  Alt  and type a decimal Unicode character code on the numeric keypad, starting from '0' ( Num Lock  must be on), like in Microsoft Word

If set, users can hold  Alt  and type a decimal ANSI character code on the numeric keypad, starting from '0', like most editors in Windows (the ANSI code page is determined by the active keyboard language).

Visual options

Option

Meaning

rvoNoCaretHighlightJumps

If set, hyperlinks will not be highlighted (with HoverColor and HoverBackColor) when the caret is moved inside them.

rvoHideReadOnlyCaret

If set, the editor hides the caret in read-only mode

Drag&drop options

Option

Meaning

rvoDragDropPicturesFromLinks

If set, when an URL is dropped in the editor, if this is a link to an image, the editor tries to insert it as an image, not as a link.

The most probably, the link points to a remote image, so it needs to be downloaded before insertion. You can do it in OnImportPicture event.

If rvoAssignImageFileNames in Options, the component assigns a "file name" property for this image.

 

Hypertext options

Option

Meaning

rvoCtrlJumps

If set (default), the editor switches to the hypertext mode (highlighting hypertext items under mouse cursor, using hypertext cursors, generating OnJump and OnRVMouseMove) when the user presses and holds  Ctrl * key

The editor switches back to the editing mode when the user releases  Ctrl * key or changes document, or if the editor loses focus.

* on macOS,  Command  is used instead of  Ctrl .

rvoNoReadOnlyJumps

If not set (default), the editor automatically switches to the hypertext mode when it becomes read-only.

If set, hyperlinks in a read-only mode work like in a normal mode.

Protection options

Option

Meaning

rvoFastDeleteProtectedText

 

Specifies how a selected fragment that contains a modify-protected* text partially is deleted.

If not set (default), deletion is not allowed (the user must select the protected text completely to delete it).

If set, the selected fragment is deleted together with all the protected text (on deletion, the selection is automatically expanded to include the protected text completely).

* the protected text's style has rvprModifyProtect in Protection, and does not have rvprDeleteProtect option there.

Other options

Option

Meaning

rvoClearTagOnStyleApp

If set, editor clears tags (set to '') of all text items when changing their style index using ApplyTextStyle or ApplyStyleConversion method.

rvoAutoSwitchLang

Obsolete, does nothing.

Default value (changed in v1.9):

[rvoWantTabs, rvoCtrlJumps]

See also:

Options.

See also events:

OnJump;

OnRVMouseMove.

See also:

TRVStyle.SpacesInTab;

RichView Hypertext;

Tags.