windowsforms-devexpress-dot-xtrascheduler-dot-timelineviewappointmentdisplayoptionsex-1094c297.md
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.v25.2.dll
NuGet Package : DevExpress.Win.Scheduler
[DefaultValue(StretchAppointmentsMode.GrowOnly)]
[XtraSerializableProperty]
public StretchAppointmentsMode StretchAppointmentsMode { get; set; }
<DefaultValue(StretchAppointmentsMode.GrowOnly)>
<XtraSerializableProperty>
Public Property StretchAppointmentsMode As StretchAppointmentsMode
| 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.
|
You can access this nested property as listed below:
| Object Type | Path to StretchAppointmentsMode |
|---|---|
| TimelineView |
.AppointmentDisplayOptions .StretchAppointmentsMode
|
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.
See Also
TimelineViewAppointmentDisplayOptionsEx Class