CopyPasteOptions.PasteUnstyledRtfMode Property

Specifies how to apply formatting to the pasted RTF text which has no defined styles.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v19.1.Core.dll

Declaration

C#

[Browsable(false)]
[DefaultValue(PasteMode.UseDestinationStyles)]
public PasteMode PasteUnstyledRtfMode { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(PasteMode.UseDestinationStyles)>
Public Property PasteUnstyledRtfMode As PasteMode

Property Value

Type	Default	Description
PasteMode	**UseDestinationStyles**	A PasteMode enumeration member that specifies the default behavior when pasting formatted text.

Available values:

Name	Description
KeepSourceFormatting	Does not apply formatting of the destination document to the pasted text.
UseDestinationStyles	Applies the style characteristics of the surrounding text to the pasted text except for formatting specified in RTF of the text being pasted.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to PasteUnstyledRtfMode
WinForms Controls	SnapControlOptions	.CopyPaste.PasteUnstyledRtfMode
	RichEditControlOptions	.CopyPaste.PasteUnstyledRtfMode
WPF Controls	RichEditControlOptions	.CopyPaste.PasteUnstyledRtfMode
Office File API	RichEditControlOptionsBase	.CopyPaste.PasteUnstyledRtfMode

Remarks

Note

We recommend that you use the CopyPasteOptions.InsertOptions property to specify how to apply formatting to the pasted text.

The default option PasteMode.UseDestinationStyles uses the style definition of the document where the text is being pasted. If the pasted RTF text does not have styles (such as the text copied from MS WordPad), the text takes on the style characteristics of the paragraph where it is pasted. The text also takes on any direct formatting specified in RTF. However, text formatted with Times New Roman, 12 is presumed to be free of font formatting. Hence, the font Times New Roman, 12 is substituted with default document font.

Another option, PasteMode.KeepSourceFormatting, applies direct formatting contained in the source RTF to the text being inserted, so it looks exactly like the source document from which it was copied.