Report Wizard Pages

• Oct 02, 2023
• 4 minutes to read

This document lists pages included in the Report Wizard along with classes defining presenters and page views that correspond to WinForms implementation. 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.XtraReports.Wizards.Views 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	ChooseReportTypePageView

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	MasterDetailSelectDataMembersPageView
  Add Grouping Levels	MasterDetailAddGroupingLevelPage<TModel>	IMasterDetailAddGroupingLevelPageView	MasterDetailAddGroupingLevelPageView
  Specify Summary Options	MasterDetailChooseSummaryOptionsPage<TModel>	IMasterDetailChooseSummaryOptionsPageView	MasterDetailChooseSummaryOptionsPageView
  Specify Report Page Settings	ConfigureReportPageSettingsPage<TModel>	IConfigureReportPageSettingsPageView	ConfigureReportPageSettingsPageView
  Choose a Report Color Scheme	ChooseReportColorSchemePage<TModel>	IChooseReportColorSchemePageView	ChooseReportColorSchemePageView
  Set the Report Title	SetReportTitlePage<TModel>	ISetReportTitlePageView	SetReportTitlePageView

• 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	MultiQuerySelectFieldsPageView
  Add Grouping Levels (Obsolete)	AddGroupingLevelPage<TModel>	IAddGroupingLevelPageView	AddGroupingLevelPageView
  Specify Summary Options (Obsolete)	ChooseSummaryOptionsPage<TModel>	IChooseSummaryOptionsPageView	ChooseSummaryOptionsPageView
  Choose a Report Layout (Obsolete)	ChooseReportLayoutPage<TModel>	IChooseReportLayoutPageView	ChooseReportLayoutPageView
  Choose a Report Style (Obsolete)	ChooseReportStylePage<TModel>	IChooseReportStylePageView	ChooseReportStylePageView
  Set the Report Title	SetReportTitlePage<TModel>	ISetReportTitlePageView	SetReportTitlePageView

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	ChooseReportTemplatePageView

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	MapReportTemplateFieldsPageView
Specify Report Template Options	SpecifyReportTemplateOptionsPage<TModel>	ISpecifyReportTemplateOptionsPageView	SpecifyReportTemplateOptionsPageView

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	SelectLabelTypePageView
Customize the Label Options	CustomizeLabelPage<TModel>	ICustomizeLabelPageView	CustomizeLabelPageView