WeekViewAppointmentDisplayOptions.SnapToCellsMode Property

Overrides the AppointmentDisplayOptions.SnapToCellsMode property to hide it.

Namespace: DevExpress.XtraScheduler

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

NuGet Package: DevExpress.Scheduler.CoreDesktop

Declaration

C#

[Browsable(false)]
public override AppointmentSnapToCellsMode SnapToCellsMode { get; set; }

VB.NET

<Browsable(False)>
Public Overrides Property SnapToCellsMode As AppointmentSnapToCellsMode

Property Value

Type	Description
AppointmentSnapToCellsMode	Returns AppointmentSnapToCellsMode.Always

Available values:

Name	Description
Auto	Appointment is stretched to cell border only if the distance from the cell border to the edge of an appointment is less than half of the cell width.
Always	An appointment is always stretched to cell borders so that it occupies the entire cell or several cells.
Never	The appointment visible width is proportional to its duration. There is a minimal visible width (about 5 pixels). If an appointment’s duration is quite small, it will never be narrower than the minimal width.
Disabled	The appointment visible width is proportional to its duration. The minimal value of a dimension that represents the appointment duration is one pixel. The following picture illustrates the difference between the Disabled and Never modes for an appointment with a very small duration. The Disabled mode displays appointment as a line with a height of one pixel; however in Never mode, it looks like a small appointment with a height of several pixels, rather than a line.

Remarks

This property is intended to hide the corresponding property of the AppointmentDisplayOptions class.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SnapToCellsMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-scheduler-resolve-appointment-conflicts/CS/DXApplication1/Form1.cs#L61

    schedulerControl1.Views.TimelineView.AppointmentDisplayOptions.SnapToCellsMode = AppointmentSnapToCellsMode.Always;
    schedulerControl1.Views.MonthView.AppointmentDisplayOptions.SnapToCellsMode = AppointmentSnapToCellsMode.Always;
}

VB.NET

winforms-scheduler-resolve-appointment-conflicts/VB/DXApplication1/Form1.vb#L50

    schedulerControl1.Views.TimelineView.AppointmentDisplayOptions.SnapToCellsMode = AppointmentSnapToCellsMode.Always
    schedulerControl1.Views.MonthView.AppointmentDisplayOptions.SnapToCellsMode = AppointmentSnapToCellsMode.Always
End Sub