The requested page is not available for the requested platform. You are viewing the content for Default platform.

ASPxClientReportDesigner.CustomizeElements Event

Enables you to customize the Web Report Designer's UI elements.

Namespace: DevExpress.XtraReports.Web.Scripts

Assembly: DevExpress.XtraReports.v18.2.Web.Scripts.dll

Declaration

public event ASPxClientReportDesignerCustomizeElementsEventHandler CustomizeElements
Public Event CustomizeElements As ASPxClientReportDesignerCustomizeElementsEventHandler

Event Data

The CustomizeElements event handler receives an argument of the ASPxClientCustomizeElementsEventArgs type. The following properties provide information specific to this event.

Property Description
Elements Provides access to the collection of UI elements.

Remarks

The event argument provides access to the ASPxClientCustomizeElementsEventArgs.Elements collection containing all available elements of the Report Designer.

The ASPxClientCustomizeElementsEventArgs.GetById method allows you to obtain the required element by its ID using the DevExpress.Designer.Report.ReportDesignerElements object. The following elements are available within this object:

  • MenuButton - corresponds to the menu button in the upper-left corner of the Designer's user interfaces.
  • NavigationPanel - corresponds to the panel at the bottom of the Designer displaying opened report tabs.
  • RightPanel - corresponds to the panel at the right of the Designer and containing tabs with the Field List, Report Explorer and Properties Panel.
  • Surface - corresponds to the design surface.
  • Toolbar - corresponds to the Report Designer Toolbar.
  • Toolbox - corresponds to the Toolbox containing report controls.

The code sample below demonstrates how to use the CustomizeElements event to hide the Report Designer's Toolbar.

<script type="text/javascript" id="script">
    function customizeElements(s, e) {
        var toolbarPart = e.GetById(DevExpress.Designer.Report.ReportDesignerElements.Toolbar);
        var index = e.Elements.indexOf(toolbarPart);
        e.Elements.splice(index, 1);
    }
</script>

<dx:ASPxReportDesigner ID="ASPxReportDesigner1" runat="server">        
    <ClientSideEvents CustomizeElements="customizeElements"/> 
</dx:ASPxReportDesigner>

To customize elements of the Document Preview built into the Report Designer, handle the ASPxClientReportDesigner.PreviewCustomizeElements event.

See Also