Skip to main content

DayViewBase.SnapToCellsMode Property

Gets or sets the method of snapping appointments to time cells in the Day View, Work Week View, and Week View. This is a dependency property.

Namespace: DevExpress.Xpf.Scheduling

Assembly: DevExpress.Xpf.Scheduling.v24.1.dll

NuGet Package: DevExpress.Wpf.Scheduling

Declaration

public SnapToCellsMode SnapToCellsMode { get; set; }

Property Value

Type Description
SnapToCellsMode

A SnapToCellsMode enumeration member specifying the snap method.

Available values:

Name Description
Auto

Appointment is stretched to a cell border only if the appointment start and end are located in the same cell or in adjacent cells.

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. However, there is a minimal visible width (TimelineView.AppointmentMinWidth) or height (DayViewBase.AppointmentMinHeight). If an appointment’s duration is quite small, it will never be narrower than the minimal value.

Remarks

The images below demonstrate different snap modes for the Day View:

  • SnapToCellsMode.Auto

    An appointment is stretched to cell borders only if the appointment’s start and end are located in the same cell or in adjacent cells.

    WPFScheduler_DayView_SnapToCells_Auto

  • SnapToCellsMode.Always

    An appointment is always stretched to cell borders so that it occupies the entire cell or several cells.

    WPFScheduler_DayView_SnapToCells_Always

  • SnapToCellsMode.Never

    The appointment height is proportional to its duration. If an appointment’s duration is less than the current time cell interval, its height is defined by the DayViewBase.AppointmentMinHeight property value.

    WPFScheduler_DayView_SnapToCells_Never

The following code snippets (auto-collected from DevExpress Examples) contain references 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.

See Also