xtrareports-devexpress-dot-xtrareports-dot-userdesigner-94367909.md
Provides data for the XtraReport.DesignerLoaded and XRDesignPanel.DesignerHostLoaded events.
Namespace : DevExpress.XtraReports.UserDesigner
Assembly : DevExpress.XtraReports.v25.2.dll
NuGet Package : DevExpress.Reporting.Core
public class DesignerLoadedEventArgs :
EventArgs
Public Class DesignerLoadedEventArgs
Inherits EventArgs
DesignerLoadedEventArgs is the data class for the following events:
The XtraReport.DesignerLoaded and XRDesignPanel.DesignerHostLoaded events occur after any report has been loaded into the End-User Designer. The DesignerLoadedEventArgs class introduces the DesignerLoadedEventArgs.DesignerHost property that specifies the designer host, which provides all the services used when editing a report.
Note
DesignerLoadedEventArgs objects are automatically created, initialized and passed to the XtraReport.DesignerLoaded or XRDesignPanel.DesignerHostLoaded event handler.
This example adds a custom control to the toolbox in the End-User Report Designer for Winforms. The XtraReport.DesignerLoaded event is used to access the toolbox service.
Tip
This code adds the XRZipCode control to the toolbox. It is hidden by default because most countries do not use it.
See Use Custom Controls to learn how to create custom report controls and add them to a Report Designer’s toolbox.
using DevExpress.XtraReports.UI;
using DevExpress.XtraReports.UserDesigner;
using System.Drawing.Design;
// ...
private void button1_Click(object sender, System.EventArgs e) {
XtraReport1 report = new XtraReport1();
ReportDesignTool designTool = new ReportDesignTool(report);
report.DesignerLoaded += report_DesignerLoaded;
designTool.ShowRibbonDesignerDialog();
}
void report_DesignerLoaded(object sender, DesignerLoadedEventArgs e) {
// Access the Toolbox service.
IToolboxService toolboxService =
(IToolboxService)e.DesignerHost.GetService(typeof(IToolboxService));
// Add a custom control to the default category.
toolboxService.AddToolboxItem(new ToolboxItem(typeof(XRZipCode)));
// Add a custom control to a new category.
// toolboxService.AddToolboxItem(new ToolboxItem(typeof(XRZipCode)), "New Category");
}
Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraReports.UserDesigner
Imports System.Drawing.Design
' ...
Private Sub button1_Click(sender As Object, e As System.EventArgs)
Dim report As New XtraReport1()
Dim designTool As New ReportDesignTool(report)
AddHandler report.DesignerLoaded, AddressOf report_DesignerLoaded
designTool.ShowRibbonDesignerDialog()
End Sub
Private Sub report_DesignerLoaded(sender As Object, e As DesignerLoadedEventArgs)
' Access the Toolbox service.
Dim toolboxService As IToolboxService = _
DirectCast(e.DesignerHost.GetService(GetType(IToolboxService)), IToolboxService)
' Add a custom control to the default category.
toolboxService.AddToolboxItem(New ToolboxItem(GetType(XRZipCode)))
' Add a custom control to a new category.
' toolboxService.AddToolboxItem(New ToolboxItem(GetType(XRZipCode)), "New Category")
End Sub
Object EventArgs DesignerLoadedEventArgs
See Also