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

XRDesignPanel.DesignerHostLoaded Event

Occurs after the designer host is activated for a report currently being edited in the current Design Panel.

Namespace: DevExpress.XtraReports.UserDesigner

Assembly: DevExpress.XtraReports.v19.1.Extensions.dll

Declaration

public event DesignerLoadedEventHandler DesignerHostLoaded
Public Event DesignerHostLoaded As DesignerLoadedEventHandler

Event Data

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

Property Description
DesignerHost Gets the designer host which provides all the services that are available for editing a report in its End-User Designer.

Remarks

Use the DesignerHostLoaded event, to perform particular actions (for instance, customize the designer's Toolbox), after all initialization has been performed (all the hosts and services required by the End-User Designer have been initialized) and the Designer is ready to be shown.

Examples

This example illustrates how to add a custom control to an End-User Report Designer's toolbox by handling the XtraReport.DesignerLoaded event and accessing 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 Using Custom and Third-Party 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) {
    // Create a report instance.
    XtraReport1 report = new XtraReport1();

    // Create a Design Tool and assign the report to it.
    ReportDesignTool designTool = new ReportDesignTool(report);

    // Handle the DesignerLoaded event of the report.
    report.DesignerLoaded += report_DesignerLoaded;

    // Load a Report Designer in a dialog window.
    // designTool.ShowDesignerDialog();
    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");
}
See Also