TimelineViewAppointmentDisplayOptionsEx.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

C#

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

VB.NET

<DefaultValue(StretchAppointmentsMode.GrowOnly)>
<XtraSerializableProperty>
Public Property StretchAppointmentsMode As StretchAppointmentsMode

Property Value

Type	Default	Description
DevExpress.XtraScheduler.StretchAppointmentsMode	GrowOnly	GrowOnly, if the Scheduler should display the “More Appointments” button when 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
TimelineView	.AppointmentDisplayOptions .StretchAppointmentsMode

Remarks

The figure below illustrates a Scheduler cell with seven appointments.

• When the StretchAppointmentsMode property is set to its default “GrowOnly” value, two appointments are hidden under the “More Appointments” button.

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

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:

• Reduce the appointment font size in the Scheduler.Appearance.Appointment property group.

• Handle the SchedulerControl.CustomDrawAppointment event to implement a custom appearance for narrow appointments.

• Enable the AppointmentDisplayOptions.ShowClippedText property to allow partially clipped text blocks inside appointments.