Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DXRichEditCopyPasteOptions.PasteUnstyledRtfMode Property

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

Namespace: DevExpress.Xpf.RichEdit

Assembly: DevExpress.Xpf.RichEdit.v24.2.dll

NuGet Package: DevExpress.Wpf.RichEdit

#Declaration

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

#Property Value

Type Description
PasteMode

A PasteMode enumeration member that specifies the default behavior when pasting formatted text.

The default is PasteMode.UseDestinationStyles.

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
RichEditControl
.CopyPasteOptions .PasteUnstyledRtfMode

#Remarks

Note

We recommend that you use the DXRichEditCopyPasteOptions.InsertOptions property to specify how to set tab stops in the inserted content.

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 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 the 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