Skip to main content

WizardPage.InitializePage Event

Occurs when the user-defined page is displayed.

Namespace: DevExpress.XtraCharts.Wizard

Assembly: DevExpress.XtraCharts.v24.1.Wizard.dll

NuGet Package: DevExpress.Win.Charts

Declaration

public event InitializePageEventHandler InitializePage

Event Data

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

Property Description
Chart Provides access to the chart object currently being edited in the wizard.
Control Represents a user control embedded into the custom wizard page.

Remarks

Use this event to prepare the page for interaction with the user. When it contains several chart controls, you may specify the chart control which reflects the property settings specified via the Wizard.

Example

The following example demonstrates how to add a new group with a new page to the Chart Wizard at runtime.

First, create a control that becomes a page’s content. Create a new control that inherits from the WizardControlBase and drop the ChartControl onto it. This follows because the page is intended to customize the chart. The page should contain a chart control to display the changes as the settings are modified.

Then, use the following code to create a group and a page. You can handle the WizardPage.InitializePage event to get access to the contained chart control.

using DevExpress.XtraCharts.Wizard;
//...

private void ShowNewWizard() {
    // Create a Wizard instance.
    ChartWizard wiz = new ChartWizard(this.chartControl1);

    // Create a new group.
    WizardGroup MyWizardGroup = wiz.RegisterGroup("NewGroup");

    // Create a new page with a "MyPage" name, "MyHeader" as a caption, "MyDesription" 
    // as a description, without image. It contains the UserControl1.
    WizardPage MyWizardPage =  MyWizardGroup.RegisterPage(typeof(UserControl1), 
        "MyPage", "MyHeader", "MyDesription", null);

    // Subscribe to the InitializePage event.
    MyWizardPage.InitializePage += new InitializePageEventHandler (MyWizardPage_InitializePage);

    // Invoke the Wizard.
    wiz.ShowDialog();
}

void MyWizardPage_InitializePage(object sender, InitializePageEventArgs e) {
    e.Chart = ((UserControl1)e.Control).chartControl1;
}
See Also