Reporting - Report Wizard Page Settings and Color Schemes (v18.2)

Starting with the v18.2 release, the Report Wizard – in Visual Studio and the End-User Report Designers on all platforms – includes two new pages. Let’s look at these pages in detail.

Page Settings

On this page you can specify the paper size and orientation for your new report, as wella s document measurement units and document margins. You can use the miniature document preview to drag the margins into position. Of course these settings can still be changed using the Properties panel or the Smart Tag menu once you have created the report, but this new Wizard page makes it easier to get started.

Page Settings

If you would like to customize the Report Wizard to use different default settings, I recommend you check out this documentation page. In a nutshell, you need to implement the IWizardCustomizationService interface and set your default values in the method CustomizeReportWizard. For instance I might use lines like these to configure for European standards:

public void CustomizeReportWizard(IWizardCustomization<XtraReportModel> tool) {
  tool.Model.PaperKind = System.Drawing.Printing.PaperKind.A4;
  tool.Model.Unit = GraphicsUnit.Millimeter;
  // convert the standard 1 inch margins to millimeters
  tool.Model.Margins = GraphicsUnitConverter.Convert(
    tool.Model.Margins, GraphicsUnit.Inch, GraphicsUnit.Millimeter);
}

Color Schemes

The second new page shows a choice of base colors, which are assigned to report controls by the wizard. The base colors are automatically varied depending on levels of grouping or master/detail relationships, so the colors get more transparent (or less solid) the deeper the nesting is. There are 14 default color schemes:

Default Color Schemes

Alternatively you can choose a Custom base color from a picker:

Custom Color Scheme

Here you can see the colors assigned to various headers in the report designer:

Color Scheme in Report Designer

Finally I should mention that the Color Schemes page also supports customization. For instance, this snippet removes two of the standard scheme tiles and adds a custom one instead:

public void CustomizeReportWizard(IWizardCustomization<XtraReportModel> tool) {
  var colorSchemeStorage =
    (IColorSchemeStorage)tool.Resolve(typeof(IColorSchemeStorage));
  colorSchemeStorage.RemoveColorScheme(ColorSchemeNames.Yellow);
  colorSchemeStorage.RemoveColorScheme(ColorSchemeNames.LightGreen);

  colorSchemeStorage.AddColorScheme(new ColorScheme("MyScheme", "My Scheme",
    System.Drawing.Color.FromArgb(255, 34, 140, 34)));
}

Your Feedback is Valuable!

What do you think about the new Report Wizard pages? Do you have ideas for other features you’d like to see included in the Report Wizard in the future?

4 comment(s)
Sara Radmaneshs

Excellent and

Thank you for your notification.

26 October, 2018
Mr Leigh

Fantastic introduction to these changes! Will these be included in .NET Core also? The extensibility of IWizardCustomizationService looks great, can't wait to get started plumbing this in. Great job as always DX! :)

26 October, 2018
Roman Prochazka

Great feature! Thanks for your interesting new features.

26 October, 2018
Dmitry Tok (DevExpress Support)

Hi everyone,

Thank you for your compliments. My team and I are pleased to hear that you like these new Report Wizard features.

@Mr Leigh: Do you mean that you need to customize the wizard for our Web Report Designer in the ASP.NET Core app? I'm interested to know the details of the desired wizard's appearance and it would be great if you describe them in a support center ticket.

29 October, 2018

Please login or register to post comments.