Skip to main content

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.v24.1.Core.Desktop.dll

NuGet Package: DevExpress.Scheduler.CoreDesktop

Declaration

[XtraSerializableProperty]
public virtual HeaderImageSizeMode ImageSizeMode { get; set; }

Property Value

Type Description
HeaderImageSizeMode

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

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