AppointmentFormControllerBase Class

Serves as a base class to provide the basic functionality for managing the appointment at the appointment’s editing form.

Namespace: DevExpress.XtraScheduler.UI

Assembly: DevExpress.XtraScheduler.v18.1.Core.dll

Declaration

C#

public abstract class AppointmentFormControllerBase :
    AppointmentModificationControllerBase

VB.NET

Public MustInherit Class AppointmentFormControllerBase
    Inherits AppointmentModificationControllerBase

Remarks

The AppointmentFormControllerBase class provides a copy of the selected appointment so the end-user can safely modify the needed characteristics - AppointmentFormControllerBase.Start, AppointmentFormControllerBase.End, AppointmentFormControllerBase.Subject, AppointmentFormControllerBase.Location, etc. It is used to create the recurrence series and apply the recurrence pattern using the PrepareToRecurrenceEdit and ApplyRecurrence methods. After all changes are made, they should be applied to the original scheduler’s appointment using the ApplyChanges method.

The appointment can also be deleted - the AppointmentFormControllerBase.CanDeleteAppointment indicates whether this is possible, and the AppointmentFormControllerBase.DeleteAppointment method accomplishes this.

For more information, please refer to the How to: Create a Custom Appointment Recurrence Form (Method 1) article and demo applications.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AppointmentFormControllerBase class.

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-localize-winforms-scheduler-ui-using-the-localizer-class-descendant-t391865/CS/SchedulerLocalizerExample/OutlookAppointmentForm.cs#L299

protected internal virtual void OnEdtEndDateInvalidValue(object sender, InvalidValueExceptionEventArgs e) {
    if (!AppointmentFormControllerBase.ValidateInterval(edtStartDate.DateTime.Date, edtStartTime.Time.TimeOfDay, edtEndDate.DateTime.Date, edtEndTime.Time.TimeOfDay))
        e.ErrorText = SchedulerLocalizer.GetString(SchedulerStringId.Msg_InvalidEndDate);

how-to-create-a-custom-recurrence-form-using-the-appointmentrecurrenceform-descendant-t220994/CS/CustomRecurrenceFormDescendantSample/MyAppointmentRecurrenceForm.cs#L9

public MyAppointmentRecurrenceForm(Appointment pattern,
    FirstDayOfWeek firstDayOfWeek, AppointmentFormControllerBase controller,
    RecurrenceType type) : base(pattern, firstDayOfWeek, controller)

dxscheduler-for-wpf-complete-implementation-of-a-custom-edit-appointment-form-e3374/CS/CustomAppointmentForm.xaml.cs#L147

protected internal virtual bool IsValidInterval(DateTime startDate, TimeSpan startTime, DateTime endDate, TimeSpan endTime) {
    return AppointmentFormControllerBase.ValidateInterval(startDate, startTime, endDate, endTime);
}

getting-started-with-the-scheduler-e5124/CS/SchedulerGettingStarted/CustomAppointmentForm.cs#L317

{
    return AppointmentFormControllerBase.ValidateInterval(edtStartDate.DateTime.Date, edtStartTime.Time.TimeOfDay, edtEndDate.DateTime.Date, edtEndTime.Time.TimeOfDay);
}

lesson-7-create-a-custom-appointment-edit-form-t342127/CS/SchedulerDbExample/CustomAppointmentForm.cs#L282

protected internal virtual bool IsValidInterval() {
    return AppointmentFormControllerBase.ValidateInterval(edtStartDate.DateTime.Date, edtStartTime.Time.TimeOfDay, edtEndDate.DateTime.Date, edtEndTime.Time.TimeOfDay);
}

VB.NET

how-to-localize-winforms-scheduler-ui-using-the-localizer-class-descendant-t391865/VB/SchedulerLocalizationExample_VB/OutlookAppointmentForm.vb#L331

Protected Friend Overridable Sub OnEdtEndDateInvalidValue(sender As Object, e As InvalidValueExceptionEventArgs)
    If Not AppointmentFormControllerBase.ValidateInterval(edtStartDate.DateTime.[Date], edtStartTime.Time.TimeOfDay, edtEndDate.DateTime.[Date], edtEndTime.Time.TimeOfDay) Then
        e.ErrorText = SchedulerLocalizer.GetString(SchedulerStringId.Msg_InvalidEndDate)

how-to-create-a-custom-recurrence-form-using-the-appointmentrecurrenceform-descendant-t220994/VB/CustomRecurrenceFormDescendantSample/MyAppointmentRecurrenceForm.vb#L8

Public Sub New(ByVal pattern As Appointment, ByVal firstDayOfWeek As FirstDayOfWeek, ByVal controller As AppointmentFormControllerBase, ByVal type As RecurrenceType)
    MyBase.New(pattern, firstDayOfWeek, controller)

getting-started-with-the-scheduler-e5124/VB/SchedulerGettingStarted/CustomAppointmentForm.vb#L342

Protected Friend Overridable Function IsValidInterval() As Boolean
    Return AppointmentFormControllerBase.ValidateInterval(edtStartDate.DateTime.Date, edtStartTime.Time.TimeOfDay, edtEndDate.DateTime.Date, edtEndTime.Time.TimeOfDay)
End Function

lesson-7-create-a-custom-appointment-edit-form-t342127/VB/SchedulerDbExample/CustomAppointmentForm.vb#L344

Protected Friend Overridable Function IsValidInterval() As Boolean
    Return AppointmentFormControllerBase.ValidateInterval(edtStartDate.DateTime.Date, edtStartTime.Time.TimeOfDay, edtEndDate.DateTime.Date, edtEndTime.Time.TimeOfDay)
End Function

Inheritance

Object

AppointmentModificationControllerBase

AppointmentFormControllerBase

AppointmentFormController

AppointmentFormController