Skip to main content
A newer version of this page is available. .

Resource Headers

  • 2 minutes to read

The Resource Headers display information about Resources, assigned to appointments. They are visible only when the appointments are grouped by resources or dates (use the SchedulerControl.GroupType property to set grouping).


The ResourceHeader base class and its descendants - HorizontalResourceHeader and VerticalResourceHeader classes - contain the information required to paint the resource headers in different views.

The resource header contains the picture specified by the Resource.ImageBytes property (fetched from the ResourceMappingInfo.Image data field if the scheduler is bound to a data source) and the Resource.Caption text that is bound to the ResourceMappingInfo.Caption data field.

The visual layout of the header is defined by the SchedulerResourceHeaderOptions object available via the SchedulerOptionsView.ResourceHeaders property. It specifies the following parameters:




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.

Set it to false to make the caption in the vertical resource headers horizontal.

The table below lists the properties and methods which affect the Resource header’s appearance:


BaseHeaderAppearance.HeaderCaption provides the appearance settings for all headers except the Today header. The appearance settings used to paint the Today header are provided by the BaseHeaderAppearance.AlternateHeaderCaption property. The BaseHeaderAppearance.HeaderCaptionLine contains settings used to paint the horizontal line under the header. If a scheduler control is painted in the WindowsXP or Skin style, the appearance settings used to paint the backgrounds of day headers are ignored.

Appearance Customization Event

Handle the SchedulerControl.LayoutViewInfoCustomizing event to access the object which contains the information used to render a visual element.

Custom Draw Event