CellsAutoHeightOptions.MaxHeight Property

Gets or sets the maximum time cell height. This property is in effect only when the CellsAutoHeightOptions.AutoHeightMode property equals “Full”.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v23.2.Core.Desktop.dll

NuGet Package: DevExpress.Scheduler.CoreDesktop

Declaration

C#

[DefaultValue(0)]
public int MaxHeight { get; set; }

VB.NET

<DefaultValue(0)>
Public Property MaxHeight As Integer

Property Value

Type	Default	Description
Int32	0	The maximum time cell height.

Property Paths

You can access this nested property as listed below:

Object Type	Path to MaxHeight
TimelineView	.CellsAutoHeightOptions .MaxHeight

Remarks

When the SchedulerViewBase.GroupType property is SchedulerGroupType.Resource, the Scheduler can automatically calculate time cell heights and resize these cells in the Timeline View. There are three time cell height modes:

Fixed Height

• CellsAutoHeightOptions.AutoHeightMode is SchedulerCellAutoHeightMode.None.
• TimelineView.ResourceHeight is a positive number (not available for Gantt Views).

This mode allows you to specify the height of time cells. Pixel scrolling is also enabled in this mode.

Limited Auto-Height

• CellsAutoHeightOptions.AutoHeightMode is SchedulerCellAutoHeightMode.Limited.
• SchedulerViewBase.ResourcesPerPage is a positive number. All resources are displayed if this property is not specified.
• CellsAutoHeightOptions.MinHeight is optional and specifies the minimum height of time cells.

In this mode, the View client area is divided into equal N parts (depending on the ResourcesPerPage option). If a time cell has too many appointments, it occupies other cells that are empty. These cells shrink until they reach the MinHeight property value, or the minimum appointment height. If a time cell needs more space to display its appointments and the visible cells cannot shrink, the View shows the “More Appointments” button. This button switches the Scheduler to the Day View that shows all appointments scheduled for this date.

Users can scroll the View vertically only by resources, pixel scrolling is not available.

Auto-Height

• CellsAutoHeightOptions.AutoHeightMode is SchedulerCellAutoHeightMode.Full.
• Optional CellsAutoHeightOptions.MinHeight and CellsAutoHeightOptions.MaxHeight properties limit the height of time cells.

In this mode, time cells are resized according to the MinHeight and MaxHeight values. The actual time cell height depends on the number of appointments. The “More Appointments” button is available for time cells that require more height than the MaxHeight property permits.

The ResourcesPerPage property is ignored in this mode. The Timeline View can display trimmed Resources and pixel scrolling is enabled.

For the Gantt View, the “Full” AutoHeightMode setting is identical to “Limited”.

Ribbon Button

The “Cell Auto Height” button in the Ribbon UI generated by Scheduler Control toggles cell auto-height. The control retains the last active auto-hide mode, and applies it when a user presses this button.