SchedulerControl.FormCustomizationUsingMVVMLocal Property

Gets or set a value indicating whether to use the MVVM design pattern to display the custom appointment editing forms.

Namespace: DevExpress.Xpf.Scheduler

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

Declaration

C#

public DefaultBoolean FormCustomizationUsingMVVMLocal { get; set; }

VB.NET

Public Property FormCustomizationUsingMVVMLocal As DefaultBoolean

Property Value

Type	Description
DefaultBoolean	A DefaultBoolean enumeration value specifying whether the MVVM-based mechanism for form display should be used.

Available values:

Name	Description
True	Corresponds to a Boolean value of true.
False	Corresponds to a Boolean value of false.
Default	The value is determined by the current object’s parent object setting (e.g., a control setting).

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.

Set the FormCustomizationUsingMVVMLocal property to true to activate a new MVVM-based mechanism for form display, which allows you to substitute the default appointment editing forms with the custom ones. To utilize this mechanism throughout your application for all SchedulerControl instances, use the static SchedulerControl.FormCustomizationUsingMVVM property. For an example on how to substitute the standard appointment editing form with a custom one using the MVVM architectural pattern, refer to the Lesson 7 - Create a Custom Edit Appointment Form Using the MVVM Pattern (legacy) document.

You can also use the form display events of the SchedulerControl to replace the default appointment editing forms. To do this, set the FormCustomizationUsingMVVMLocal property to false and handle the appropriate event depending on the form you want to customize. This approach is described in the Lesson 9 - Create a Custom Edit Appointment Form (legacy) article.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FormCustomizationUsingMVVMLocal 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-customize-the-mvvm-appointment-recurrence-form-without-creating-a-custom-form-t224208/CS/MainWindow.xaml#L19

<Grid>
    <dxsch:SchedulerControl x:Name="Scheduler" ActiveViewType="Timeline" GroupType="Resource" FormCustomizationUsingMVVMLocal="True">
        <dxsch:SchedulerControl.Storage>

dxscheduler-getting-started-create-a-custom-edit-appointment-form-e2499/CS/SchedulerCustomAppointmentForm/MainWindow.xaml#L9

<!--region #xaml_event-->
<dxsch:SchedulerControl x:Name="Scheduler" EditAppointmentFormShowing="Scheduler_EditAppointmentFormShowing" FormCustomizationUsingMVVMLocal="False"
                        ActiveViewType="Week" GroupType="None">

how-to-invoke-the-default-appointment-recurrence-dialog-from-a-custom-edit-appointment-form-e3796/VB/WpfApplication1/MainWindow.xaml#L11

GroupType="Resource"
FormCustomizationUsingMVVMLocal="False"
EditAppointmentFormShowing="schedulerControl1_EditAppointmentFormShowing"

how-to-create-a-custom-edit-appointment-form-using-the-mvvm-pattern-t103885/CS/MVVMSchedulerApplication/MainWindow.xaml#L14

<Grid>
    <dxsch:SchedulerControl x:Name="Scheduler" ActiveViewType="Day" GroupType="Resource" FormCustomizationUsingMVVMLocal="True">
        <dxsch:SchedulerControl.AppointmentFormServiceTemplate>

how-to-create-a-custom-appointment-recurrence-dialog-using-the-mvvm-pattern-t181757/VB/MVVMSchedulerApplication/MainWindow.xaml#L19

<Grid>
    <dxsch:SchedulerControl x:Name="Scheduler" ActiveViewType="Day" GroupType="Resource" FormCustomizationUsingMVVMLocal="True">
        <dxsch:SchedulerControl.AppointmentFormServiceTemplate>