[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [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]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
   [Expand]Product Information
    Getting Started
   [Expand]Scheduler Elements and Structure
   [Expand]Data Binding
   [Expand]Import and Export
   [Expand]Time Zones
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
   [Expand]Member Tables
   [Collapse]Visual Elements
    [Collapse]Scheduler Control
      All-Day Area
      Appointment Flyout
      Date Navigation Bar
      Day Headers
      Day of Week Headers
      Group Separator
      More Buttons
      Navigation Buttons
      Resource Headers
      Resource Navigator
      Status Lines
      Time Cells
      Time Ruler
      Time Indicator
      Time Scales
      Selection Bar
      Scroll More Buttons
    [Expand]Command UI
     Resources Tree
     Date Navigator
     Auxiliary Controls
     Reporting Controls
     Pop-up Menus
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Resource Headers

The ResourceHeader class represents a resource header that displays a caption and an image. Headers are only visible when appointments are grouped by a resource or date. Use the SchedulerControl.GroupType property to group appointments.

The HorizontalResourceHeader and VerticalResourceHeader classes represent a resource header displayed horizontally and vertically. The header orientation depends on the applied view.

The Resource.ImageBytes property (mapped to the ResourceMappingInfo.Image data field) specifies the image displayed in the header. The Resource.Caption property (mapped to the ResourceMappingInfo.Caption data field) specifies the header caption.

Expanded Layout Options

The SchedulerOptionsView.ResourceHeaders property provides access to the following options related to the resource headers.




Gets or sets the height of the resource header.


Gets or sets the image alignment within a resource header.


Gets or sets the size of an image which is shown within a resource header.


Gets or sets the size mode of an image which is displayed within a resource header.


Gets or sets the value indicating whether to rotate the caption's text.

Disable this option to display captions in vertical headers horizontally.

Expanded Appearance Settings

A ResourceHeader object's Appearance property provides access to appearance settings applied to resource headers. The table below contains available settings.




Gets the appearance settings used to paint headers.


Gets the appearance settings used to paint the horizontal line under the header.


Gets the appearance settings used to paint a selection within the View.


Gets the appearance settings used to paint the alternate (Today) header.


Gets the appearance settings used to paint the horizontal line under the alternate (Today) header.


Gets the appearance settings used to paint an additional header shown in the Agenda View and far aligned.


Gets the appearance settings used to paint additional alternate ("Today") header shown in the Agenda View and far aligned.


If a skin is applied, background colors for Day Headers are not in effect.

Expanded Customization Events

The SchedulerControl.LayoutViewInfoCustomizing event fires before a time cell, day header, day-of-week header, or resource header is displayed and allows you to customize them.

The SchedulerControl.CustomDrawResourceHeader event fires before a resource header is displayed and allows you to draw it manually.

Expanded Resource Category Headers

If resources are organized into categories, category headers are displayed instead of resource headers. A category header displays captions of the resources that belong to the category. Use the ResourceCategory.Caption property to provide a custom caption for the category.

You can also set the ResourceCategoryOptions.ResourceDisplayStyle property to Tabs to display resource headers as tabs that users can select. To display appointments associated with the selected resource (tab) only, set the ResourceCategoryOptions.AppointmentDisplayMode property to SelectedResource.

Is this topic helpful?​​​​​​​