WizardGroup Class

OBSOLETE

The ChartWizard is obsolete now. Use the ChartDesigner instead.

Represents a group of pages in the Chart Wizard.

Namespace: DevExpress.XtraCharts.Wizard

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

NuGet Package: DevExpress.Win.Charts

Declaration

C#

[Obsolete("The ChartWizard is obsolete now. Use the ChartDesigner instead.")]
public class WizardGroup :
    IEnumerable

VB.NET

<Obsolete("The ChartWizard is obsolete now. Use the ChartDesigner instead.")>
Public Class WizardGroup
    Implements IEnumerable

Related API Members

The following members return WizardGroup objects:

• ChartWizard.ConstructionGroup
• ChartWizard.PresentationGroup
• ChartWizard.RegisterGroup(String)
• WizardPage.Group

Remarks

The wizard pages are accessible via the WizardGroup.Pages method. A group that doesn’t contain pages is not displayed within the Wizard.

There are two predefined groups - Construction and Presentation. To create your own page you have to register it using the ChartWizard.RegisterGroup method and add a number of WizardPage objects using the WizardGroup.RegisterPage method.

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.

C#

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;
}

VB.NET

Imports DevExpress.XtraCharts.Wizard
' ...

Private Sub ShowNewWizard()
    ' Create a Wizard instance.
    Dim wiz As New ChartWizard(Me.chartControl1)

    ' Create a new group.
    Dim MyWizardGroup As WizardGroup = 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.
    Dim MyWizardPage As WizardPage = MyWizardGroup.RegisterPage(GetType(UserControl1), _
        "MyPage", "MyHeader", "MyDesription", Nothing)

    ' Subscribe to the InitializePage event.
    AddHandler MyWizardPage.InitializePage, AddressOf MyWizardPage_InitializePage

    ' Invoke the Wizard.
    wiz.ShowDialog()
End Sub

Private Sub MyWizardPage_InitializePage(ByVal sender As Object, ByVal e As InitializePageEventArgs)
     e.Chart = DirectCast(e.Control, UserControl1).chartControl1
End Sub

Inheritance

Object

WizardGroup