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.v22.2.Core.Desktop.dll

NuGet Package: DevExpress.Scheduler.CoreDesktop

Declaration

C#

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

VB.NET

<DefaultValue(HeaderImageSizeMode.CenterImage)>
Public Overridable Property ImageSizeMode As HeaderImageSizeMode

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.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ImageSizeMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-bind-a-scheduler-to-ms-access-database-at-design-time-t473371/CS/SchedulerDbAccessExample/Form1.cs#L34

schedulerControl1.OptionsView.ResourceHeaders.ImageAlign = DevExpress.XtraScheduler.HeaderImageAlign.Top;
schedulerControl1.OptionsView.ResourceHeaders.ImageSizeMode = DevExpress.XtraScheduler.HeaderImageSizeMode.ZoomImage;
schedulerControl1.OptionsView.ResourceHeaders.ImageSize = new Size(140, 70);

how-to-calculate-and-display-totals-for-visible-appointments-e977/CS/Form1.cs#L32

schedulerControl1.OptionsView.ResourceHeaders.ImageSize = new Size(100, 50);
schedulerControl1.OptionsView.ResourceHeaders.ImageSizeMode = HeaderImageSizeMode.ZoomImage;

VB.NET

how-to-bind-a-scheduler-to-ms-access-database-at-design-time-t473371/VB/SchedulerDbAccessExample/Form1.vb#L37

schedulerControl1.OptionsView.ResourceHeaders.ImageAlign = DevExpress.XtraScheduler.HeaderImageAlign.Top
schedulerControl1.OptionsView.ResourceHeaders.ImageSizeMode = DevExpress.XtraScheduler.HeaderImageSizeMode.ZoomImage
schedulerControl1.OptionsView.ResourceHeaders.ImageSize = New Size(140, 70)

how-to-calculate-and-display-totals-for-visible-appointments-e977/VB/Form1.vb#L34

schedulerControl1.OptionsView.ResourceHeaders.ImageSize = New Size(100, 50)
schedulerControl1.OptionsView.ResourceHeaders.ImageSizeMode = HeaderImageSizeMode.ZoomImage