Skip to main content

CopyPasteOptions.PasteUnstyledRtfMode Property

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

Namespace: DevExpress.XtraRichEdit

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

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

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

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:

Object Type Path to PasteUnstyledRtfMode
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.

See Also