ASPxClientReportDesigner.CustomizeToolbox Event

Enables you to customize the Web Report Designer's available controls.

Namespace: DevExpress.XtraReports.Web.Scripts

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

Declaration

public event ASPxClientReportDesignerCustomizeToolboxEventHandler CustomizeToolbox
Public Event CustomizeToolbox As ASPxClientReportDesignerCustomizeToolboxEventHandler

The ASPxClientReportDesignerCustomizeToolboxEventArgs.ControlsFactory event argument provides information about all controls available in the Toolbox and provides various methods for their customization.

Change Toolbox Item Tooltips

The following code snippet demonstrates how to specify a custom tooltip for the Label control. Use the getControlInfo method to obtain the specified control's information and change the displayName property.

function customizeToolbox(s, e) {
    e.ControlsFactory.getControlInfo("XRLabel").displayName = "My Custom Text";
}

Manage Expression Properties

You can use the setExpressionBinding and hideExpressionBindings methods to manage properties displayed in the right panel's Expressions tab. The example below shows how to hide the Label control's specific properties and add the Font property to a new custom category.

function customizeToolbox(s, e) {
    e.ControlsFactory.hideExpressionBindings("XRLabel", "Font", "ForeColor", "Text", "TextAlignment");
    e.ControlsFactory.setExpressionBinding("XRLabel", "Font", ["BeforePrint"], "My category", ["Bold"]);
}

Register Custom Controls

The inheritControl and registerControl methods allow you to create a new custom control and register it in the Toolbox.

See Register a Custom Control in the Report Designer Toolbox for a step-by-step tutorial.

See Also