OptionsCustomization.AllowAppointmentCreate Property
Gets or sets a value that specifies whether an end-user is allowed to create new appointments.
Namespace: DevExpress.Xpf.Scheduler
Assembly: DevExpress.Xpf.Scheduler.v19.2.dll
Declaration
Property Value
Type | Description |
---|---|
UsedAppointmentType | A UsedAppointmentType enumeration value that specifies the type of appointment which the action can be applied to. |
Available values:
Name | Description |
---|---|
None | The action can’t be applied to any appointments. |
Recurring | The action can be applied to recurring appointments only. |
NonRecurring | The action can be applied to non-recurring appointments only. |
All | The action can be applied to all the appointments. |
Custom | The action is applied according to the custom method specified by the corresponding AllowAppointment~ or CustomAllowAppointment~ event of the SchedulerControl. |
Property Paths
You can access this nested property as listed below:
Object Type | Path to AllowAppointmentCreate |
---|---|
SchedulerControl |
|
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 are allowed to create new appointments by using UI elements such as the scheduler’s popup menu, a View’s inplace editor or the Edit Appointment dialog. Use the AllowAppointmentCreate property to control the availability of such an action for end-users, with respect to an appointment’s specific type.
Note
If the AllowAppointmentCreate property is set to UsedAppointmentType.Custom, then whether an end-user is allowed to create new appointments or not is decided in the SchedulerControl.AllowAppointmentCreate 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.
<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>
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the AllowAppointmentCreate 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.