TCustomRichView.Options

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.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;

Примечание: TRVOption и TRVOptions объявлены в модуле RVScroll/fmxRVScroll.

Примечание*: эта опция объявлена только для FireMonkey.

Значение по умолчанию:

VCL и Lazarus: [rvoAllowSelection, rvoScrollToEnd, rvoAutoCopyUnicodeText, rvoAutoCopyImage, rvoAutoCopyRVF, rvoAutoCopyRTF, rvoDblClickSelectsWord, rvoRClickDeselects, rvoFormatInvalidate, rvoShowPageBreaks, rvoShowGridLines, rvoFastFormatting]

FireMonkey: то же + [rvoDefaultSelectionFill]

Основные опции

Опция

Описание

rvoTagsArePChars

Устарела, не делает ничего.

rvoClientTextWidth

Если включена, текст всегда будет переноситься по ширине окна TRichView.

Также влияет на горизонтальные линии и таблицы.

Подробнее см. здесь.

Можно изменить в любое время, но после изменения этой опции потребуется переформатировать и перерисовать TRichView, если документ уже был отформатирован.

rvoScrollToEnd

Если включена (по умолчанию), TRichView прокручивается в самый низ при вызове метода FormatTail.

В противном случае прокрутки нет.

Может быть изменена: в любое время.

rvoSingleClick

Если включена, событие OnRVDblClick происходит при щелчке мышью.

Если нет (по умолчанию), оно происходит при двойном щелчке.

Может быть изменена: в любое время.

rvoFormatInvalidate

Если включена (по умолчанию), методы Format и FormatTail перерисовывают компонент.

Может быть изменена: в любое время.

rvoDisallowDrag

Если включена, перетаскивание из этого TRichView отключено.

Может быть изменена: в любое время.

rvoFastFormatting

Увеличивает скорость форматирования за счёт большего использования системных ресурсов.

rvoPercentEncodedURL

Если включена, считается, что адреса URL (содержащиеся в тегах или полученные в событии OnWriteHyperlink) имеют %-кодировку, поэтому дополнительное кодирование и декодирование не требуется при работе с  RTF, HTML, Markdown и DocX.

Если не включена (по умолчанию), компонент выполняет %-кодирование целей гиперссылок, сохраняемых в RTF, HTML, Markdown, DocX, и %-декодирование при загрузке из этих форматов.

rvoAssignImageFileNames

Если включена, компонент присваивает имена файлов изображениям, хранящимся в элементах документа, когда это возможно.

Эта опция влияет на изображения из внешних файлов, загруженных при чтении RTF, DocX, HTML, Markdown; вставку файлов и ссылок на изображения из буфера обмена или в результате перетаскивания; Инструменты интерфейса ТРВ (RichViewActions) (команды для вставки рисунков или назначения фоновых изображений таблицам).

Используются свойства:

table.BackgroundImageFileName

cell.BackgroundImageFileName

свойство элемента документа rvespImageFileName

См. также: событие OnAssignImageFileName.

 

Выделение фрагмента

Могут быть изменены: в любое время.

Опция

Описание

rvoAllowSelection

Если включена (по умолчанию), пользователь может выделять фрагмент в документе мышью или клавиатурой.

Пожалуйста не убирайте эту опцию у TRichViewEditor!

См.: работа с выделением.

rvoDblClickSelectsWord

Если включена (по умолчанию), двойной щелчок левой кнопки мыши выделяет слово (или нетесктовый элемент) под указателем мыши

rvoRClickDeselects

Если включена (по умолчанию), щелчок правой кнопкой мыши за пределами выделения снимает его (и перемещает каретку в место щелчка в TRichViewEdit)

 

Опции скрытия и показа

Опция

Описание

rvoShowCheckpoints

Если включена, показываются закладки (пунктирными горизонтальными линиями, или с помощью события OnDrawCheckpoint).

Может быть изменена: в любое время; требуется перерисовка содержимого.

rvoShowPageBreaks

Если включена (по умолчанию), разрывы страниц показываются горизонтальными линиями.

Может быть изменена: в любое время; требуется перерисовка содержимого.

rvoShowSpecialCharacters

Если включена, непечатаемые символы показываются специальными знаками: пробелы, неразрывные пробелы, знаки абзацев и переносов строк, табуляции, «мягкие дефисы», линии к плавающим элементам, места вставки текстовых блоков.

Может быть изменена: в любое время; требуется переформатирование, если документ был форматирован.

См. также: RVVisibleSpecialCharacters, RichViewShowGhostSpaces.

rvoShowHiddenText

Если включена, показываются скрытые элементы.

Может быть изменена: в любое время; требуется переформатирование, если документ был форматирован.

rvoShowItemHints

Если включена, показываются подсказки для элементов документа. Всплывающие подсказки показываются если свойство ShowHints = True. См. свойства элементов и событие OnItemHint.

rvoShowGridLines

Если включена, показываются линии сетки таблиц.

Может быть изменена: в любое время; требуется перерисовка содержимого.

 

Опции для работы с буфером обмена (см. подробности)

[VCL, LCL, FMX для Windows и macOS]: Если опции установлены, TRichView копирует выделенный фрагмент в буфер обмена в указанных форматах при нажатии  Ctrl + Insert  или  Ctrl + C . Эти опции также влияют на метод CopyDef. Могут быть изменены в любое время.

[FMX для всех платформ кроме Windows и macOS]: для копирования выбирается самый подходящий формат.

Опция

Формат для копирования

rvoAutoCopyText

текст ANSI (только VCL и LCL для Windows)

rvoAutoCopyUnicodeText

юникодный текст

rvoAutoCopyRVF

RVF (RichView Format)

rvoAutoCopyRTF

RTF (Rich Text Format)

rvoAutoCopyImage

Растровое изображение или metafile (если выделен рисунок)

Опции для версии FireMonkey

Опция

Описание

rvoDefaultSelectionFill

Если установлена, и ресурс типа brush с именем 'selection' присутствует в используемом визуальном стиле (указанном в свойстве StyleLookup), свойства SelColor, SelOpacity, InactiveSelColor связанного компонента TRVStyle обновляются в соответствии с этим ресурсом.