HtmlEditorHtmlEditingSettings.ProcessRtfContentPastingOnServer Property

Gets or sets a value that specifies whether to process the copied/cut RTF content on the server side.

Namespace: DevExpress.Web.ASPxHtmlEditor

Assembly: DevExpress.Web.ASPxHtmlEditor.v20.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(true)]
public bool ProcessRtfContentPastingOnServer { get; set; }

VB.NET

<DefaultValue(True)>
Public Property ProcessRtfContentPastingOnServer As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true, to process the copied/cut RTF content on the server side; otherwise, false.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ProcessRtfContentPastingOnServer
ASP.NET Controls and MVC Extensions	ASPxHtmlEditor	.SettingsHtmlEditing .ProcessRtfContentPastingOnServer
ASP.NET MVC Extensions	HtmlEditorBinderSettings	.HtmlEditingSettings .ProcessRtfContentPastingOnServer
	HtmlEditorSettings	.SettingsHtmlEditing .ProcessRtfContentPastingOnServer
	MVCxHtmlEditor	.SettingsHtmlEditing .ProcessRtfContentPastingOnServer

Remarks

To paste the RTF content from a clipboard with the original formatting, set the ProcessRtfContentPastingOnServer property to true. It enables converting the RTF content to HTML on the server and then paste it to the editor.

ASPX

<dx:ASPxHtmlEditor runat="server">
    <SettingsHtmlEditing ProcessRtfContentPastingOnServer="true"></SettingsHtmlEditing>
</dx:ASPxHtmlEditor>

The time the RTF content is processed on the server, a loading panel with the temporary HTML content is shown in the editor. The following example illustrates how to obtain the temporary HTML.

JS

function onBeforePaste(s, e) {
  if(e.html.indexOf('id="dx-tmpRtf') > -1)
      alert("The temporary content will be pasted.");    
  else
      alert("Default behavior.");
}

ASPX

<dx:ASPxHtmlEditor ID="ASPxHtmlEditor1" runat="server">
    <ClientSideEvents BeforePaste="onBeforePaste" />
    <SettingsHtmlEditing ProcessRtfContentPastingOnServer="true"></SettingsHtmlEditing>
</dx:ASPxHtmlEditor>

Settings for images from the RTF content are specified by the HtmlEditorDefaultDialogSettings.InsertImageDialog property (provided that the ASPxHtmlEditorSettings.AllowSaveBinaryImageToServer property is set to true).

ASPX

<SettingsDialogs>
    <InsertImageDialog>
        <SettingsImageUpload UploadStorage="...">
        </SettingsImageUpload>
    </InsertImageDialog>
</SettingsDialogs>

Note that with the enabled ProcessRtfContentPastingOnServer property, the ASPxClientHtmlEditor.BeforePaste and ASPxClientHtmlEditor.HtmlChanged client events are raised both before and after the content processing.

Known Limitations

• Internet Explorer and Microsoft Edge don’t provide access to the RTF content in clipboard.
• The ProcessRtfContentPastingOnServer property is not in effect if the ASPxHtmlEditorHtmlEditingSettings.PasteMode property is set to HtmlEditorPasteMode.PlainText and the ASPxHtmlEditorHtmlEditingSettings.EnablePasteOptions is disabled.
• The ProcessRtfContentPastingOnServer property is not in effect if the copied/cut content doesn’t contain raw text/rtf data.