OptionsCustomization.AllowAppointmentConflicts Property

Gets or sets a value that specifies whether an end-user is allowed to share the schedule time between two or more appointments.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v18.2.dll

Declaration

C#

public AppointmentConflictsMode AllowAppointmentConflicts { get; set; }

VB.NET

Public Property AllowAppointmentConflicts As AppointmentConflictsMode

Property Value

Type	Description
AppointmentConflictsMode	A AppointmentConflictsMode enumeration value specifying whether the time interval of two or more appointments can intersect or not, if these appointments belong to the same resource(s).

Available values:

Name	Description
Allowed	Appointments conflicts are allowed. This means that appointment intervals can intersect for the same resource (or for at least for one of the resources to which they belong, if resources are shared).
Forbidden	Appointments conflicts are forbidden. This means that appointment intervals can’t intersect each other for the same resource (or for at least for one of the resources to which they belong, if resources are shared).
Custom	Whether the conflicts are resolved or not is determined manually in the corresponding event handler.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AllowAppointmentConflicts
SchedulerControl	.OptionsCustomization.AllowAppointmentConflicts

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

By default, end-users can share the schedule time between two or more appointments. Use the AllowAppointmentConflicts property to control the availability of such functionality to end-users.

If this property is set to AppointmentConflictsMode.Allowed, the time interval of two or more appointments can intersect and sharing the schedule time between the appointments is allowed. Set the AllowAppointmentConflicts property to AppointmentConflictsMode.Forbidden to prevent scheduling (or rescheduling) of two or more appointments for the same time.

Note

If the AllowAppointmentConflicts property is set to AppointmentConflictsMode.Custom, then whether an end-user is allowed to share the schedule time between two or more appointments or not is decided in the SchedulerControl.AllowAppointmentConflicts event handler.

Example

This example demonstrates how to prevent end-users from having appointments within a certain time interval (from 2 PM to 3 PM). To implement end-user restrictions, handle the SchedulerControl.AllowAppointmentCreate event to prevent end-users from creating appointments within a certain time interval and the SchedulerControl.AllowAppointmentConflicts event to prevent an existing appointment from being dragged to the same time interval:

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-set-end-user-restrictions-e2516.

MainWindow.xaml (C#)

<Window x:Class="WpfApplication1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduler"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <dxsch:SchedulerControl Name="schedulerControl1"
                                HorizontalAlignment="Stretch" VerticalAlignment="Stretch"                               
                                AllowAppointmentConflicts="schedulerControl1_AllowAppointmentConflicts" 
                                AllowAppointmentCreate="schedulerControl1_AllowAppointmentCreate">
            <dxsch:SchedulerControl.DayView>
                <dxsch:DayView DayCount="3" />
            </dxsch:SchedulerControl.DayView>
            <dxsch:SchedulerControl.OptionsCustomization>
                <dxsch:OptionsCustomization AllowAppointmentConflicts="Custom" AllowAppointmentCreate="Custom" />
            </dxsch:SchedulerControl.OptionsCustomization>
        </dxsch:SchedulerControl>
    </Grid>
</Window>

MainWindow.xaml.cs

using System;
using System.Windows;
using DevExpress.XtraScheduler;
using DevExpress.Xpf.Scheduler;

namespace WpfApplication1 {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
        }
        TimeOfDayInterval restrictedArea = 
            new TimeOfDayInterval(TimeSpan.FromHours(14), TimeSpan.FromHours(15));

        private void schedulerControl1_AllowAppointmentConflicts(object sender,
            AppointmentConflictEventArgs e) {
            TimeInterval interval = e.Interval;
            if (!IsIntervalAllowed(interval))
                e.Conflicts.Add(e.AppointmentClone);
        }

        private void schedulerControl1_AllowAppointmentCreate(object sender, 
            AppointmentOperationEventArgs e) {
            e.Allow = IsIntervalAllowed(schedulerControl1.ActiveView.SelectedInterval);
        }

        private bool IsIntervalAllowed(TimeInterval interval) {
            DateTime dayStart = interval.Start.Date;
            while (dayStart < interval.End) {
                if (!IsIntervalAllowed(interval, dayStart))
                    return false;
                dayStart = dayStart.AddDays(1);
            }
            return true;
        }

        bool IsIntervalAllowed(TimeInterval interval, DateTime dayStart) {
            TimeInterval lunchTime = new TimeInterval(dayStart.Add(restrictedArea.Start), 
                dayStart.Add(restrictedArea.End));
            return !interval.IntersectsWithExcludingBounds(lunchTime);
        }        
    }
}

MainWindow.xaml (VB.NET)

<Window x:Class="WpfApplication1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduler"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <dxsch:SchedulerControl Name="schedulerControl1"
                                HorizontalAlignment="Stretch" VerticalAlignment="Stretch"                               
                                AllowAppointmentConflicts="schedulerControl1_AllowAppointmentConflicts" 
                                AllowAppointmentCreate="schedulerControl1_AllowAppointmentCreate">
            <dxsch:SchedulerControl.DayView>
                <dxsch:DayView DayCount="3" />
            </dxsch:SchedulerControl.DayView>
            <dxsch:SchedulerControl.OptionsCustomization>
                <dxsch:OptionsCustomization AllowAppointmentConflicts="Custom" AllowAppointmentCreate="Custom" />
            </dxsch:SchedulerControl.OptionsCustomization>
        </dxsch:SchedulerControl>
    </Grid>
</Window>

MainWindow.xaml.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Windows
Imports DevExpress.XtraScheduler
Imports DevExpress.Xpf.Scheduler

Namespace WpfApplication1
    Partial Public Class MainWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub
        Private restrictedArea As New TimeOfDayInterval(TimeSpan.FromHours(14), TimeSpan.FromHours(15))

        Private Sub schedulerControl1_AllowAppointmentConflicts(ByVal sender As Object, _
                                                          ByVal e As AppointmentConflictEventArgs)
            Dim interval As TimeInterval = e.Interval
            If (Not IsIntervalAllowed(interval)) Then
                e.Conflicts.Add(e.AppointmentClone)
            End If
        End Sub

        Private Sub schedulerControl1_AllowAppointmentCreate(ByVal sender As Object, _
                                                             ByVal e As AppointmentOperationEventArgs)
            e.Allow = IsIntervalAllowed(schedulerControl1.ActiveView.SelectedInterval)
        End Sub

        Private Function IsIntervalAllowed(ByVal interval As TimeInterval) As Boolean
            Dim dayStart As DateTime = interval.Start.Date
            Do While dayStart < interval.End
                If (Not IsIntervalAllowed(interval, dayStart)) Then
                    Return False
                End If
                dayStart = dayStart.AddDays(1)
            Loop
            Return True
        End Function

        Private Function IsIntervalAllowed(ByVal interval As TimeInterval, _
                                           ByVal dayStart As DateTime) As Boolean
            Dim lunchTime As New TimeInterval(dayStart.Add(restrictedArea.Start), _
                                              dayStart.Add(restrictedArea.End))
            Return Not interval.IntersectsWithExcludingBounds(lunchTime)
        End Function
    End Class
End Namespace

Related GitHub Examples

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

how-to-set-end-user-restrictions-e2516/CS/WpfApplication1/MainWindow.xaml#L15

<dxsch:SchedulerControl.OptionsCustomization>
    <dxsch:OptionsCustomization AllowAppointmentConflicts="Custom" AllowAppointmentCreate="Custom" />
</dxsch:SchedulerControl.OptionsCustomization>

wpf-schedulercontrol-api-t442105/CS/SchedulerControl_WPF_API/CodeExamples/AppointmentConflicts.cs#L10

 //Concurrent appointments with the same resource are not allowed.
scheduler.OptionsCustomization.AllowAppointmentConflicts = AppointmentConflictsMode.Custom;
 scheduler.AllowAppointmentConflicts += Scheduler_AllowAppointmentConflicts;

VB.NET

wpf-schedulercontrol-api-t442105/VB/SchedulerControl_WPF_API/CodeExamples/AppointmentConflicts.vb#L9

 'Concurrent appointments with the same resource are not allowed.
scheduler.OptionsCustomization.AllowAppointmentConflicts = AppointmentConflictsMode.Custom
 AddHandler scheduler.AllowAppointmentConflicts, AddressOf Scheduler_AllowAppointmentConflicts