All docs
V18.2
21.1 (EAP/Beta)
The page you are viewing does not exist in version 21.1. This link will take you to the root page.
20.2
The page you are viewing does not exist in version 20.2. This link will take you to the root page.
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
18.1
17.2

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

Event Data

The CustomizeToolbox event's data class is ASPxClientReportDesignerCustomizeToolboxEventArgs. The following properties provide information specific to this event:

Property Description
ControlsFactory Provides information about all controls available in the Toolbox.

Remarks

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