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.