Skip to main content

CellsAutoHeightOptions Class

Options that configure automatic time cell height.

Namespace: DevExpress.XtraScheduler

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

NuGet Package: DevExpress.Scheduler.CoreDesktop


public class CellsAutoHeightOptions :

The following members return CellsAutoHeightOptions objects:


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

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

Limited Auto-Height

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.

Limited Autosize mode in DevExpress Scheduler, Timeline View

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


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.

Full Autosize mode in DevExpress Scheduler, Timeline View

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.

Cell Auto Height button in Ribbon Control

See Also