Skip to main content

ASPxHtmlEditor Class

An HTML text editor control.

Namespace: DevExpress.Web.ASPxHtmlEditor

Assembly: DevExpress.Web.ASPxHtmlEditor.v24.1.dll

NuGet Package: DevExpress.Web

#Declaration

public class ASPxHtmlEditor :
    ASPxWebControl,
    IRequiresLoadPostDataControl,
    IParentSkinOwner,
    ISkinOwner,
    IPropertiesOwner,
    IValidationSummaryEditor,
    IControlDesigner,
    IStyleSheetManagerImagesProvider

#Remarks

The ASPxHtmlEditor class is a visual control that enables non-technical users to easily edit HTML markup as an ordinary rich text document.

ASPxHtmlEditor_control.png

#Create an HTML Editor

#Design Time

The ASPxHtmlEditor control is available on the DX.24.1: Common Controls toolbox tab in the Microsoft Visual Studio IDE.

Drag the control onto a form and customize the control’s settings, or paste the control’s markup in the page’s source code.

<dx:ASPxHtmlEditor ID="htmlEditor" runat="server" ActiveView="Html">
    <SettingsDialogs>
        <InsertImageDialog>
            <SettingsImageUpload>
                <ValidationSettings AllowedFileExtensions=".jpe,.jpeg,.jpg,.gif,.png" MaxFileSize="500000">
                </ValidationSettings>
            </SettingsImageUpload>
        </InsertImageDialog>
    </SettingsDialogs>
</dx:ASPxHtmlEditor>

#Run Time

using DevExpress.Web.ASPxHtmlEditor;
...
protected void Page_Load(object sender, EventArgs e)
{
    ASPxHtmlEditor new_htmlEditor = new ASPxHtmlEditor();
    new_htmlEditor.ID = "htmlEditor";
    Page.Form.Controls.Add(new_htmlEditor);

    new_htmlEditor.ActiveView = HtmlEditorView.Html;
    string[] extensions = {".jpe", ".jpeg", ".jpg", ".gif", ".png"};
    new_htmlEditor.SettingsDialogs.InsertImageDialog.SettingsImageUpload.ValidationSettings.AllowedFileExtensions = extensions;
    new_htmlEditor.SettingsDialogs.InsertImageDialog.SettingsImageUpload.ValidationSettings.MaxFileSize = 500000;
}

Note

DevExpress controls require that you register special modules, handlers, and options in the Web.config file. You can change this file or switch to the Design tab in the Microsoft Visual Studio IDE to automatically update the Web.config file. Note that this information is automatically registered if you use the DevExpress Template Gallery to create a project.

The ASPxHtmlEditor control provides three view modes.

  • Design view allows end-users to modify the editor content using various design tools (such as toolbars and context menu), and instantly see the results.
  • Html view allows end-users to modify the editor content using HTML markup.
  • Preview allows end-users to view the editor content as a regular webpage.

The active view can be specified using the ASPxHtmlEditor.ActiveView property.

ASPxHtmlEditor allows you to programmatically access the HTML content both on the client and server sides. To learn more, see the Get and Set HTML section.

The appearance of the control and its different elements can be widely customized with the help of specific style and image settings. To learn more, see the Visual Elements section.

Note

Client Functionality The ASPxHtmlEditor control provides you with a comprehensive client-side functionality implemented using JavaScript code.

The client-side API is always available for this control.

To try the ASPxHtmlEditor control functionality, see Online Demos.

#Example

In markup:

protected void ASPxHtmlEditor1_HtmlChanged(object sender, EventArgs e)
{
    //custom code
}

Programmatically:

protected void Page_Init(object sender, EventArgs e) {
    DevExpress.Web.ASPxHtmlEditor.ASPxHtmlEditor he = new DevExpress.Web.ASPxHtmlEditor.ASPxHtmlEditor();
    he.ID = "he1";
    Form.Controls.Add(he);

    he.Html = "<b>Hello, World</b>";
    he.HtmlChanged += new EventHandler<EventArgs>(he_HtmlChanged);
    //...
}

void he_HtmlChanged(object sender, EventArgs e) {
    //code 
}
See Also