Edit this page

Loading the Dialogs from External Files

Externalizing the Dialogs

By default, all RadImageEditor dialogs are embedded as resource fils in the Telerik.Web.UI.dll file, which makes their customization harder. In order to provide an easy way to modify the ImageEditor's dialogs, since Q1 2012, the Telerik® UI for ASP.NET Ajax installation now comes with an extrafolder named ImageEditorDialogs which contains the dialogs' ascx files. You can configure RadImageEditor to use the external dialog files by copying the ImageEditorDialogs folder to the root of the web site and setting the ExternalDialogsPath property (also available since Q1 2012) to point to it, e.g.

note

In order to use the external dialogs of the control in a precompiled site scenario you have to manually copy the folder with the modified dialogs to the precompiled version of the site.

<telerik:RadImageEditor RenderMode="Lightweight" ID="RadImageEditor1" ExternalDialogsPath="~/ImageEditorDialogs" runat="server">
</telerik:RadImageEditor>

Examples

This example demonstrates how to add fonts in the AddText dialog's dropdown:

  1. Copy the ImageEditorDialogs folder to the root of the web site.

  2. Set the ExternalDialogsPath property to point to the folder where you copied the files (e.g. ExternalDialogsPath="~/ImageEditorDialogs")

  3. Open the AddText.ascx file and locate the RadComboBox with ID fontFamily so you can add more options to it:

<telerik:RadComboBox RenderMode="Lightweight" ID="fontFamily" runat="server" AutoPostBack="false" EnableViewState="false"
  CausesValidation="false" Width="130px">
  <Items>
    <telerik:RadComboBoxItem Text="Arial" Value="arial" />
    <telerik:RadComboBoxItem Text="Times New Roman" Value="times new roman" />
    <telerik:RadComboBoxItem Text="Verdana" Value="verdana" />
    <telerik:RadComboBoxItem Text="Tahoma" Value="tahoma" />

    <telerik:RadComboBoxItem Text="Courier New" Value="courier new" />
    <telerik:RadComboBoxItem Text="Georgia" Value="georgia" />
    <telerik:RadComboBoxItem Text="Ms Sans Serif" Value="ms sans serif" />
  </Items>
</telerik:RadComboBox>

If you want to hide some functionality in some dialog, you can do that by applying style="display:none" to it. For example, here is how to hide the Preset Size dropdown in the Resize dialog:

<tr style="display: none;">
    <td class="rieRightAligned">
        <label id="lblPresetSizes" runat="server">
            Preset Sizes:</label>
    </td>
    <td colspan="2">
        <telerik:RadComboBox RenderMode="Lightweight" ID="PresetSizes" runat="server" AutoPostBack="false" EnableViewState="false"
            CausesValidation="false" Width="140px">
            <Items>
                <telerik:RadComboBoxItem Text="Original W x H" Value="original" />
                <telerik:RadComboBoxItem Text="Custom W x H" Value="custom" />
                <telerik:RadComboBoxItem Text="800x600px" Value="800,600" />
                <telerik:RadComboBoxItem Text="1024x768px" Value="1024,768" />
                <telerik:RadComboBoxItem Text="1280x1024px" Value="1280,1024" />
                <telerik:RadComboBoxItem Text="1440x900px" Value="1440,900" />
            </Items>
        </telerik:RadComboBox>
    </td>
. . . .