ToolbarInsertImageDialogButton Class

A default toolbar button that invokes an image dialog allowing an image to be inserted into the design view area.

Namespace: DevExpress.Web.ASPxHtmlEditor

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

Declaration

C#
VB.NET

public class ToolbarInsertImageDialogButton :
    HtmlEditorToolbarItem

Public Class ToolbarInsertImageDialogButton
    Inherits HtmlEditorToolbarItem

Remarks

ASPxHtmlEditor supports working with images within the design view area, by using the specific image dialogs that can be invoked by clicking the Insert Image button (of the ToolbarInsertImageDialogButton type).

You can add the Insert Image button to toolbars by using either the ASPxHtmlEditor designer at design time, or programmatically.

C#
ASPX

protected void Page_Load(object sender, EventArgs e) {
    HtmlEditorToolbar stToolbar1 = HtmlEditorToolbar.CreateStandardToolbar1();
    ToolbarInsertImageDialogButton imgButton = new ToolbarInsertImageDialogButton();
    stToolbar1.Items.Add(imgButton);
    ASPxHtmlEditor1.Toolbars.Add(stToolbar1);
}

<dx:ASPxHtmlEditor ID="ASPxHtmlEditor1" runat="server">
    <Toolbars>
        <dx:HtmlEditorToolbar Name="StandardToolbar1">
            <Items>
                <dx:ToolbarInsertImageDialogButton>
                </dx:ToolbarInsertImageDialogButton>
            </Items>
        </dx:HtmlEditorToolbar>
    </Toolbars>
</dx:ASPxHtmlEditor>

The image upload settings are defined by the following properties:

Property	Description
ASPxHtmlEditorImageUploadSettings.UploadImageFolder	Specifies the location of a folder where images uploaded by the ASPxHtmlEditor control should be stored.
ASPxHtmlEditorImageUploadSettings.ValidationSettings	Use this property to access and customize the settings that relate to the validation of image files uploaded using the ASPxHtmlEditor control.
ASPxHtmlEditorSettings.AllowInsertDirectImageUrls	This property specifies whether direct links to the specified images located on other web sites may be inserted into the editor’s HTML markup.