windowsforms-5753-controls-and-libraries-scheduler-reporting-scheduler-report-controls-and-components.md
This document introduces the Scheduler report controls, used to display various information in a Scheduler report. They are only available if you own both the XtraScheduler and XtraReports Suites (they use functionality from each product library). All these controls can be added to a report, at either Visual Studio design time or in the End-User Report Designer. You can programmatically add the controls to a report created at runtime, as well.
A Scheduler Report Control represents a specific report element which can be inserted into a report. It descends from the XtraReport class called XtraSchedulerReport. This class has the normal banded report designer, used in the XtraReports Suite.
Note
Current implementation requires that report controls reside inside the DetailBand only, and not in the other report bands.
The Scheduler Report Controls require the Scheduler Report View Components for their operation. This is much like the view that exists in the XtraScheduler control, so there are ReportDayView, ReportWeekView, ReportMonthView and ReportTimelineView components. They are responsible for composing the data obtained via the SchedulerControlPrintAdapter or SchedulerStoragePrintAdapter, and providing the data to the Scheduler Report Controls.
The appearance and behavior of a report control is defined by its type. See the section below to learn more about different report control types available in the current version of XtraScheduler Reporting.
Note
Report controls can be used only in XtraScheduler Reports, and they automatically populate the Visual Studio toolbox when the report designer becomes active. However, these controls can’t be added to a Form instance, and are missing in the Visual Studio toolbox if the Windows Forms designer is active.
All report controls are inherited from the base DevExpress.XtraScheduler.Reporting.ReportRelatedControlBase class. This class provides the basic functionality that is required by the objects that display and handle information in Scheduler reports.
Below is a list of basic report controls available in XtraSchedulerReports.
| Scheduler Report Control | Description |
|---|---|
| DayViewTimeCells | A time cells control representing the Scheduler’s Day View. It can be used to print one or more days, which do not have to be consecutive. |
| HorizontalWeek | A time cells control representing the Scheduler’s Month View. It can be used to print a week or several weeks. |
| FullWeek | A time cells control representing the Scheduler’s Week View. It can be used to print one or more weeks in a compact style. |
| TimelineCells | A time cells control representing the Scheduler’s Timeline View. It can visualize appointments using different time scales. |
| HorizontalDateHeaders | A header control used to print dates for the columns of time cells . |
| DayOfWeekHeaders | A header control used to print days of the week for the HorizontalWeek control. |
| TimelineScaleHeaders | A header control used to print time scales for the ReportTimelineView. |
| HorizontalResourceHeaders | A header control used to print resources for the columns of time cells. |
| VerticalResourceHeaders | A vertical header control used to print resources for the rows of time cells. |
| DayViewTimeRuler | A control used to print a time ruler on the left side of the linked DayViewTimeCells control. |
| TimeIntervalInfo | A control used to print a textual representation of the time interval. |
| FormatTimeIntervalInfo | A control used to print a textual representation of the time interval using a wide range of available formats. |
| ResourceInfo | A control used to print a list of resources. |
| Scheduler Report Component | Description |
|---|---|
| ReportDayView | A View component for a daily style report. |
| ReportWeekView | A View component for a week-style report. |
| ReportMonthView | A View component for a monthly (multi-week) style report. |
| ReportTimelineView | A View component for a timeline style report. |
| SchedulerControlPrintAdapter | Scheduler print adapter bound to the SchedulerControl. |
| SchedulerStoragePrintAdapter | Scheduler print adapter bound to the SchedulerStorage |
The Scheduler Report control displays report content in the Detail report band.
You can also add the Group Header report bands to display headers on every page or at the start of a group.
Use the context menu in the Report Designer to add group headers.
Then, place report elements inside the headers. Click the group header’s smart tag and select “Repeat Every Page“ to show group headers on every page.
Group headers specified to repeat every page are displayed on every page, other group headers are added when a new group starts.
Report controls can be added to a report at design time or in code. These methods are illustrated below:
Design time.
Runtime.