SchedulerResourceHeaderOptionsBase.ImageSizeMode Property

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

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v21.1.Core.Desktop.dll

Declaration

[DefaultValue(HeaderImageSizeMode.CenterImage)]
public virtual HeaderImageSizeMode ImageSizeMode { get; set; }

Property Value

Type Default Description
HeaderImageSizeMode

CenterImage

A HeaderImageSizeMode enumeration value which specifies how the image is displayed, resized or clipped.

Available values:

Name Description
Normal

The image is displayed in the center of the resource header. If the image is larger than the resource header, its top left corner is fit into the header, and the other edges are clipped.

CenterImage

The image is displayed in the center of the resource header. If the image is larger than the resource header, it is centered and the outside edges are clipped.

StretchImage

The image within the resource header is stretched or shrunk to the SchedulerResourceHeaderOptions.ImageSize value.

If the ImageSize equals 0 and the SchedulerResourceHeaderOptionsBase.Height > 0, the image’s height or width (depending on the current view - Day View or Timeline View) is set to the SchedulerResourceHeaderOptionsBase.Height value. If the ImageSize equals 0 and the SchedulerResourceHeaderOptionsBase.Height < = 0, the image’s height or width (depending on the current view - Day View or Timeline View) is calculated as 1/6 of the view’s height (or width).

ZoomImage

The image within the resource header is resized, maintaining the size ratio.

It is resized to the SchedulerResourceHeaderOptions.ImageSize value if it is greater than zero. If the ImageSize equals 0 and the SchedulerResourceHeaderOptionsBase.Height > 0, the image’s height or width (depending on the current view - Day View or Timeline View) is set to the SchedulerResourceHeaderOptionsBase.Height value. If the ImageSize equals 0 and the SchedulerResourceHeaderOptionsBase.Height < = 0, the image’s height or width (depending on the current view - Day View or Timeline View) is calculated as 1/6 of the view’s height (or width).

Property Paths

You can access this nested property as listed below:

Library Object Type Path to ImageSizeMode
WinForms Controls HorizontalResourceHeaders
.Options.ImageSizeMode
VerticalResourceHeaders
.Options.ImageSizeMode
SchedulerOptionsView
.ResourceHeaders.ImageSizeMode
ASP.NET Bootstrap Controls BootstrapSchedulerOptionsView
.ResourceHeaders.ImageSizeMode
ASP.NET Web Forms Controls ASPxSchedulerOptionsView
.ResourceHeaders.ImageSizeMode

Remarks

When the image size is calculated, the space required to place a header caption is neglected. Therefore, a header caption is visible only if the image leaves room for it after being displayed.

See Also