Skip to main content
All docs
V24.1

MonthViewAppointmentDisplayOptionsEx.StretchAppointmentsMode Property

When a Scheduler cell has too many appointments, the Scheduler hides some of them under the “More Appointments” button to maintain readability. This property allows you to force the Scheduler cells to display all of their appointments. This property is in effect only when the AppointmentDisplayOptions.StretchAppointments setting is on.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v24.1.dll

NuGet Package: DevExpress.Win.Scheduler

Declaration

[DefaultValue(StretchAppointmentsMode.GrowOnly)]
[XtraSerializableProperty]
public StretchAppointmentsMode StretchAppointmentsMode { get; set; }

Property Value

Type Default Description
DevExpress.XtraScheduler.StretchAppointmentsMode GrowOnly

GrowOnly, if the Scheduler should display the “More Appointments” button in case a cell has too many appointments. GrowAndShrink, if cells can squeeze appointments to display all of them at once.

Property Paths

You can access this nested property as listed below:

Object Type Path to StretchAppointmentsMode
MonthView
.AppointmentDisplayOptions .StretchAppointmentsMode

Remarks

The figure below illustrates a Scheduler cell with 10 appointments.

  • When the StretchAppointmentsMode property is set to its default “GrowOnly” value, seven appointments are hidden under the “More Appointments” button (when a user clicks it, the Scheduler switches to Day View).

  • When the StretchAppointmentsMode property equals “GrowAndShrink”, all 10 appointments are displayed at once.

Scheduler Stretch Appointments Mode

Note that in “GrowAndShrink” mode, the height of appointments can become shorter than the font size. Such narrow appointments show no text, and the only way for users to identify an appointment is to hover over it (a flyout with detailed appointment information will pop up). To enhance the user experience, you can try the following:

See Also