<< Click to display table of contents >> TCustomRVFontInfo.Protection |
Protects text of this style from specific operations in editor.
property Protection: TRVProtectOptions;
type
TRVProtectOption =
(rvprStyleProtect, rvprStyleSplitProtect,
rvprModifyProtect,
rvprDeleteProtect, rvprConcateProtect,
rvprRVFInsertProtect, rvprDoNotAutoSwitch,
rvprParaStartProtect,
rvprSticking, rvprSticking2, rvprSticking3,
rvprStickToTop, rvprStickToBottom);
TRVProtectOptions = set of TRVProtectOption;
Used in RichViewEdit. Text of this style has special behavior when editing.
Option |
Meaning |
---|---|
rvprStyleProtect |
Protects text from changing style with ApplyTextStyle, ApplyTextStyleTemplate, ApplyStyleTemplate. This protection is ignored by ApplyStyleConversion, but you can take it into account manually in OnStyleConversion event. |
rvprStyleSplitProtect |
Protects from applying text style to the part of text item. ApplyTextStyle and ApplyStyleConversion methods apply new style to the whole item having this protection, even if it is selected only partially. |
rvprModifyProtect |
Protects text items of this style from modification, but does not protect from deleting as a whole. Deletion depends on rvoFastDeleteProtectedText option in TRichViewEdit.EditorOptions. |
rvprDeleteProtect |
Protects text items of this style from deletion as a whole, but does not protect from modification. Normally, this option blocks all operations deleting the last character of the protected text item. But if EmptyWidth > 0, all characters can be deleted, but the item is not deleted. See also: rvepDeleteProtect item property. |
rvprConcateProtect |
Protects texts items from concatenation with adjacent item of the same style. |
rvprRVFInsertProtect |
If set, items of this style will not be inserted when inserting RVF. Affects methods introduced in editor only (InsertRV***Ed, pasting). |
rvprDoNotAutoSwitch |
If set, editor never switches the current text style to this one automatically. If this style was made current by the user (by assigning CurTextStyleNo property), the editor switches back to another (previously used) style after the first performed operation. |
rvprParaStartProtect |
Disallows moving text item of this style to/from new line; blocks Enter key when the caret is in text of this style. |
Option |
Meaning |
---|---|
rvprSticking |
Disallows insertion between two text items having this protection (allows to stick together several text items of different text styles). |
rvprSticking2 |
The same. |
rvprSticking3 |
The same. |
rvprStickToTop |
Disallows insertion before the text of this style, if this text is a first document item. |
rvprStickToBottom |
Disallows insertion after the text of this style, if this text is a last document item. |
rvprSticking, rvprSticking2, and rvprSticking3 allow to create several groups of stuck items. It's not possible to insert something between items having the same protection option, but it's possible to insert between items having different options, for example rvprSticking and rvprSticking2. In addition to these options, you can use OnCheckStickingItems event.
Note:
TFontInfo.SingleSymbols property is removed in version 1.3. When loading forms saved with an older version, or when loading styles from ini-files or registry, SingleSymbols=True is converted to Protection=[rvprStyleProtect, rvprDoNotAutoSwitch].
Default value:
[]
See also:
▪Options of paragraph style;
▪EmptyWidth property
Demo projects:
▪Demos\*\Assorted\Fields\