How to: Customize the Appointment Dialog using View Model API (simple customization)

• Aug 01, 2019
• 2 minutes to read

Note

The information provided below is relevant only for DevExpress ASP.NET MVC Scheduler version 17.2 and later.

The View Model API enables you to customize dialog element characteristics (values, availability, and layout) as needed.

This topic covers several common scenarios on how to customize the Appointment Dialog’s content and layout using the View Model API. In most cases, the ViewModel.PrepareControlFor and ViewModel.PrepareControl methods are used to access the Appointment Dialog editors.

Note

Online Example A complete sample project demonstrating this approach in action is available in the DevExpress Code Examples database at http://www.devexpress.com/example=T582018

The following code snippets illustrate how to customize editors on the dialog form:

• Replacing all Toggle editors with Check Boxes

  C#

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControl((ASPxCheckBox cb) => {
      cb.ToggleSwitchDisplayMode = ToggleSwitchDisplayMode.Never;
  });
  

  VB.NET

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControl(Sub(cb As ASPxCheckBox)
      cb.ToggleSwitchDisplayMode = ToggleSwitchDisplayMode.Never
  End Sub)
  

• Changing the “Start” and “End” editors’ DateTime format

  C#

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.StartTime, (ASPxDateEdit de) => {
      de.EditFormat = EditFormat.Custom;
      de.EditFormatString = "dd - MM - yyyy";
  });
  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.EndTime, (ASPxDateEdit de) => {
      de.EditFormat = EditFormat.Custom;
      de.EditFormatString = "dd - MM - yyyy";
  });
  

  VB.NET

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(Function(m) m.StartTime, Sub(de As ASPxDateEdit)
      de.EditFormat = EditFormat.Custom
      de.EditFormatString = "dd - MM - yyyy"
  End Sub)
  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(Function(m) m.EndTime, Sub(de As ASPxDateEdit)
      de.EditFormat = EditFormat.Custom
      de.EditFormatString = "dd - MM - yyyy"
  End Sub)
  

• Changing the “Resource” editor caption

  C#

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.ResourceIds, (ASPxComboBox de) => {
      de.Caption = "Employee";
  });
  

  VB.NET

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(Function(m) m.ResourceIds, Sub(de As ASPxComboBox)
      de.Caption = "Employee"
  End Sub)
  

• Changing the “Subject” editor caption’s forecolor and font settings

  C#

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.Subject, (ASPxTextBox de) => {
      de.CaptionStyle.ForeColor = Color.Red;
      de.CaptionStyle.Font.Bold = true;
  });
  

  VB.NET

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(Function(m) m.Subject, Sub(de As ASPxTextBox)
      de.CaptionStyle.ForeColor = Color.Red
      de.CaptionStyle.Font.Bold = True
  End Sub)
  

• Changing the “Description” editor’s forecolor and font settings.

  C#

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.Description, (ASPxMemo me) => {
      me.ForeColor = Color.Blue;
      me.Font.Bold = true;
      me.Font.Italic = true;
  });
  

  VB.NET

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(Function(m) m.Description, Sub([me] As ASPxMemo)
      [me].ForeColor = Color.Blue
      [me].Font.Bold = True
      [me].Font.Italic = True
  End Sub)
  

• Hiding the “Location” and “All-Day” editors

  C#

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition("Location", false);
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition(vm => vm.IsAllDay, false);
  

  VB.NET

  
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition("Location", False)
  settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition(Function(vm) vm.IsAllDay, False)