ContextQMD
Back to Devexpress

Runtime Customization

windowsforms-118419-common-features-data-source-wizard-wizard-customization-api-runtime-customization.md

latest2.7 KB
Original Source

Runtime Customization

  • Oct 29, 2020
  • 2 minutes to read

This document describes structural elements of a Data Source Wizard, which is used to provide data to controls.

The document consists of the following sections.

Wizard’s Structural Elements

The Data Source Wizard is used to bind a control to a data source. It is used by the SqlDataSource and ExcelDataSource components, as well as by DevExpress Reporting, Dashboard, and Snap.

The Report wizard’s architecture is based on the MVP (Model-View-Presenter) design pattern. Every wizard page is defined by a presenter and view.

  • Model stores settings defined on wizard pages. A wizard model must implement the IWizardModel interface, for example:

  • Views define the Graphical User Interface of wizard pages. Each page view is an XtraUserControl descendant populated with data editors allowing an end-user to specify particular settings. Each page view should descend from the WizardViewBase class, which implements the IWizardPageView interface.

  • Presenters define the logic behind a specific wizard page. Each presenter defines how a page is initialized, how user-specified data is processed in the context of the current page, as well as how settings specified by an end-user are submitted to the report model.

For a list of default page views and presenters used in the Data Source wizard, see Page Views and Presenters.

Wizard’s Customization API

To define wizard customization logic, implement the following interfaces.