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.
The following code snippets illustrate how to customize editors on the dialog form:
Replacing all Toggle editors with Check Boxes
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControl((ASPxCheckBox cb) => {
cb.ToggleSwitchDisplayMode = ToggleSwitchDisplayMode.Never;
});
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControl(Sub(cb As ASPxCheckBox)
cb.ToggleSwitchDisplayMode = ToggleSwitchDisplayMode.Never
End Sub)
Changing the “Start” and “End” editors’ DateTime format
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";
});
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
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.ResourceIds, (ASPxComboBox de) => {
de.Caption = "Employee";
});
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
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.Subject, (ASPxTextBox de) => {
de.CaptionStyle.ForeColor = Color.Red;
de.CaptionStyle.Font.Bold = true;
});
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.
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.PrepareControlFor(m => m.Description, (ASPxMemo me) => {
me.ForeColor = Color.Blue;
me.Font.Bold = true;
me.Font.Italic = true;
});
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
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition("Location", false);
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition(vm => vm.IsAllDay, false);
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition("Location", False)
settings.OptionsForms.DialogLayoutSettings.AppointmentDialog.ViewModel.SetItemVisibilityCondition(Function(vm) vm.IsAllDay, False)