Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Collapse]Scheduler
   [Expand]Product Information
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]Scheduler Elements
    [Expand]Scheduler Structure
    [Expand]Appointments
     Resources for Appointments
    [Expand]Views
    [Expand]Data Binding
    [Expand]Mappings
    [Expand]Supported Formats
    [Expand]Services
    [Expand]Time Zones
     Printing
    [Collapse]Scheduler Reporting
      Reporting Technique
      Scheduler Report Controls and Components
      Scripting
      Can Shrink and Can Grow Features
      SmartSync Feature
      Scheduler Report Templates
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Scheduler Report Controls and Components

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.

Expanded What is a Scheduler Report Control?

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 System.Windows.Forms.Form instance, and are missing in the Visual Studio toolbox if the Windows Forms designer is active.

Expanded Controls

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.

Expanded Components

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

Expanded Using Controls

Report controls can be added to a report at design-time or via code. These methods are illustrated below:

  • Design time.

    To add report controls at design time, drag an appropriate item from the DX.17.1: Scheduler Reporting tab of the Visual Studio toolbox, and drop it onto a report.

  • The control links itself to an appropriate View automatically. You can use smart tags to specify a link to the View component, and to another scheduler report control. The link sign indicates that the control is linked.

  • Runtime.

    To add a report control to a report at runtime, create it, and add it to the DetailBand of the report via the XRControlCollection.Add method. Make sure that the DevExpress.XtraReports.UI namespace is included in your code.

    Show Me

    A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E1390.

    The following code snippet illustrates how you can add controls at runtime to create a daily report.

    To create a report, a minimal set of controls, which includes the DayViewTimeCells, HorizontalDateHeaders, DayViewTimeRuler and a corresponding ReportDayView component, is used. They are added to the report's DetailBand, positioned and linked as required. Then, an end-user designer is invoked to display and edit the resulting report.

How would you rate this topic?​​​​​​​