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

C#

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

VB.NET

<XtraSerializableProperty>
Public Overridable Property ImageSizeMode As HeaderImageSizeMode

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.