Report Wizard Pages

• Jul 13, 2021
• 4 minutes to read

This document lists pages included in the Report Wizard along with classes defining presenters and page views that correspond to WPF implementations. Wizard pages listed in this document are divided into groups based on a corresponding wizard section.

To learn about the part of the Report Wizard that is derived from the Data Source Wizard and is used to specify data source settings, see Data Source Wizard Pages.

Wizard Structural Elements

The structural elements of the Report Wizard conform to the MVP (model-view-presenter) pattern and are contained in the following namespaces.

• Model

  Settings defined on the Report Wizard pages are stored by the ReportModel class.

  These settings are translated to the XtraReportModel class, which also stores data-related settings defined on the Data Source Wizard pages.

• Views

  Interfaces and classes identifying wizard page views are contained in the DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages namespace.

• Presenters

  Report Wizard page presenters are contained in the DevExpress.XtraReports.Wizards.Presenters namespace.

Other classes that may be used during wizard customization are contained in the following namespaces.

• DevExpress.XtraReports.Wizards
• DevExpress.XtraReports.Wizards.Labels

To learn about presenters and views corresponding to specific Report Wizard pages, see the following sections in this document.

Start Page

This wizard page allows you to select a report type to create.

Wizard Page	Page Presenter	Page View Interface	Page View
Select the Report Type	ChooseReportTypePage<TModel>	IChooseReportTypePageView	ChooseReportTypePage

Table and Vertical Reports

Initial steps of creating a table and vertical reports vary between different data source types and match with corresponding steps of the Data Source Wizard. Refer to the Data Source Wizard Pages document for a list of these pages.

The table below lists wizard pages shown after data source creation settings are specified.

• If you bind the report to a database, it is possible to construct a master-detail report and specify its grouping and summary options. The master-detail wizard implementation includes the following pages:

  Wizard Page	Page Presenter	Page View Interface	Page View
  Choose Fields to Display in a Report	MasterDetailSelectDataMembersPage<TModel>	IMasterDetailSelectDataMembersPageView	MasterDetailSelectDataMembersPage
  Add Grouping Levels	MasterDetailAddGroupingLevelPage<TModel>	IMasterDetailAddGroupingLevelPageView	MasterDetailAddGroupingLevelPage
  Specify Summary Options	MasterDetailChooseSummaryOptionsPage<TModel>	IMasterDetailChooseSummaryOptionsPageView	MasterDetailChooseSummaryOptionsPage
  Specify Report Page Settings	ConfigureReportPageSettingsPage<TModel>	IConfigureReportPageSettingsPageView	ConfigureReportPageSettingsPage
  Choose a Report Color Scheme	ChooseReportColorSchemePage<TModel>	IChooseReportColorSchemePageView	ChooseReportColorSchemePage
  Set the Report Title	SetReportTitlePage<TModel>	ISetReportTitlePageView	SetReportTitlePage

• The pages listed below appear in the Report Wizard if you bound the report to an Entity Framework data source, object data source or an Excel file. These pages are also used in the older implementation of the Report Wizard after binding a report to a database.

  Wizard Page	Page Presenter	Page View Interface	Page View
  Choose Fields to Display in a Report (Obsolete)	MultiQuerySelectFieldsPage<TModel>	IMultiQuerySelectFieldsPageView	MultiQuerySelectFieldsPage
  Add Grouping Levels (Obsolete)	AddGroupingLevelPage<TModel>	IAddGroupingLevelPageView	AddGroupingLevelPage
  Specify Summary Options (Obsolete)	ChooseSummaryOptionsPage<TModel>	IChooseSummaryOptionsPageView	ChooseSummaryOptionsPage
  Choose a Report Layout (Obsolete)	ChooseReportLayoutPage<TModel>	IChooseReportLayoutPageView	ChooseReportLayoutPage
  Choose a Report Style (Obsolete)	ChooseReportStylePage<TModel>	IChooseReportStylePageView	ChooseReportStylePage
  Set the Report Title	SetReportTitlePage<TModel>	ISetReportTitlePageView	SetReportTitlePage

  To learn how to switch back to using the older Report Wizard version, refer to How to disable the master-detail functionality in the Report Wizard.

Template Report

The following page is displayed when selecting the Template Report option on the Select the Report Type wizard page:

Wizard Page	Page Presenter	Page View Interface	Page View
Choose a Report Template	ChooseReportTemplatePage<TModel>	IChooseReportTemplatePageView	ChooseReportTemplatePage

After selecting a template, the Data Source Wizard pages are displayed, enabling you to bind the report to data. After completing the data configuration pages and selecting the fields to include in the report’s data source, the wizard displays the following pages:

Wizard Page	Page Presenter	Page View Interface	Page View
Map Report Template Fields	MapReportTemplateFieldsPage<TModel>	IMapReportTemplateFieldsPageView	MapReportTemplateFieldsPage
Specify Report Template Options	SpecifyReportTemplateOptionsPage<TModel>	ISpecifyReportTemplateOptionsPageView	SpecifyReportTemplateOptionsPage

Label Report

The following pages become available when selecting the Labels option on the Select the Report Type wizard page.

Wizard Page	Page Presenter	Page View Interface	Page View
Select the Label Type	SelectLabelTypePage<TModel>	ISelectLabelTypePageView	SelectLabelTypePage
Customize the Label Options	CustomizeLabelPage<TModel>	ICustomizeLabelPageView	CustomizeLabelPage