Skip to main content
All docs
V24.1

CellsAutoHeightOptions.AutoHeightMode Property

Gets or sets the mode used to calculate time cell heights in the Scheduler control.

Namespace: DevExpress.XtraScheduler

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

NuGet Package: DevExpress.Scheduler.CoreDesktop

Declaration

[XtraSerializableProperty]
public SchedulerCellAutoHeightMode AutoHeightMode { get; set; }

Property Value

Type Description
DevExpress.XtraScheduler.SchedulerCellAutoHeightMode

The selected mode: “None”, “Limited” or “Full”

Property Paths

You can access this nested property as listed below:

Object Type Path to AutoHeightMode
TimelineView
.CellsAutoHeightOptions .AutoHeightMode

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

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.

Auto-Height

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