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.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Scheduling, DevExpress.Wpf.Scheduling

Declaration

C#

public SnapToCellsMode SnapToCellsMode { get; set; }

VB.NET

Public Property SnapToCellsMode As SnapToCellsMode

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.

  

• SnapToCellsMode.Always

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

  

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

  

Related GitHub Examples

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.

XAML

how-to-color-time-cells-partially-t590114/CS/SchedulerCellTemplate/MainWindow.xaml#L30

    TimeRegionVisibility="{DXBinding Expr='HighlightLunchHours? $dxsch:TimeRegionVisibility.Always : $dxsch:TimeRegionVisibility.Never'}"
    SnapToCellsMode="Never" DayCount="5" TimeScale="00:30:00" />
<dxsch:SchedulerControl.DataSource>

how-to-customize-resource-headers-to-display-custom-text-and-images-t603619/CS/CustomResourceHeaderExample/MainWindow.xaml#L57

ShowWorkTimeOnly="True"
SnapToCellsMode="Never"
TimeScale="00:10:00"

how-to-handle-appointment-drag-drop-resize-operations-t605963/CS/SchedulerDragDropResizeExample/MainWindow.xaml#L87

</dxsch:SchedulerControl.DataSource>
<dxsch:DayView ResourcesPerPage="3" ShowWorkTimeOnly="True" SnapToCellsMode="Never" />
<dxsch:MonthView />