Although this tutorial is based on Windows Forms, the same steps apply for inheriting reports on any other supported platform.
Create a Base Report
The visual inheritance of reports is similar to that of Windows Forms. It allows you to create a base report, and then inherit from it and make modifications in descendant reports, while preserving the layout and settings of the original report. To learn more about visual inheritance, refer to the following MSDN article: Windows Forms Visual Inheritance.
To create a parent report, whose layout will be inherited by all descendants, do the following:
Define a layout for the default parent report. For example, create a simple static report by adding an XRLabel to its detail band. All future reports should inherit this basic layout.
The label created in the base report will be available in all inherited reports. To permit changes in an individual label's properties (independent of the base report), set the control's Modifiers property to Protected, Protected Internal or Public.
Set this property for every object that you wish to modify in inherited reports.
Before proceeding with the following steps, rebuild your application by clicking BUILD | Rebuild Solution in the main menu in Visual Studio. This will generate the application's assembly (.exe or .dll) file containing the base report class, and the inherited reports will gain access to the base report at design time.
Create an Inherited Report
To add a new inherited report to an application, do the following.
In Visual Studio, press CTRL+SHIFT+A or click PROJECT | Add New Item... in the main menu.
In the Add New Item dialog that is invoked, switch to the Reporting directory and select DevExpress v19.2 Report item.
Next, in the invoked Report Wizard, choose Inherited Report and click Next.
On the next wizard page, select an ancestor report from the list of available reports and click Finish. Now, a new report inherits its layout from this report.
Alternatively, you can select the ancestor report that is contained in a separate assembly. To do this, click Select the assembly that contains ancestor reports and, in the invoked Open Assembly dialog, select the required assembly.
Editing of the created inherited report will be prohibited unless this is allowed by the Modifiers property setting of the ancestor report.
Customize the Inherited Report
After adding the inherited report, you can add new elements to it (bands and controls), and modify the inherited elements that were made public.
When you change the property values of inherited controls, these properties are overridden in the inherited report.
To obtain the value of a property from the base report, reset this property value. To do this, select the control and locate the required property (for example, ForeColor) in the Properties window. Right-click this property and select Reset.
Was this page helpful?
Thanks for your feedback! Any other suggestions? Tell us here.