A newer version of this page is available. Switch to the current version.

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).

Docs_VisualElements_SchedulerControl_Resource_Header

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:

Parameter

Description

SchedulerResourceHeaderOptionsBase.Height

Gets or sets the height of the resource header.

SchedulerResourceHeaderOptionsBase.ImageAlign

Gets or sets the image alignment within a resource header.

SchedulerResourceHeaderOptions.ImageSize

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

SchedulerResourceHeaderOptionsBase.ImageSizeMode

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

SchedulerResourceHeaderOptionsBase.RotateCaption

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:

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

SchedulerControl.CustomDrawResourceHeader