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.v23.2.Core.Desktop.dll
NuGet Package: DevExpress.Scheduler.CoreDesktop
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). |
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.