Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Collapse]Scheduler
   [Expand]Product Information
   [Collapse]Getting Started
     Lesson 1 - Create a Simple Scheduling Application
     Lesson 2 - Create a Simple Scheduling Application with DateNavigator
     Lesson 3 - Provide Bar UI for a Scheduler
     Lesson 4 - Provide Ribbon UI for a Scheduler
     Lesson 5 - Bind a Scheduler to MS SQL Database at Design Time
     Lesson 6 - Bind a Scheduler to MS Access Database at Design Time
     Lesson 7 - Create a Custom Appointment Edit Form
     Lesson 8 - Implement a Custom Inplace Editor
   [Expand]Fundamentals
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Lesson 7 - Create a Custom Appointment Edit Form

Real-world Scheduler applications often require you to create a CustomField, to provide additional information that is not provided by standard appointment fields. The Standard Appointment Edit Form must be modified to display and edit the custom fields.

To create a Custom Appointment Edit Form, follow the instructions below.

Expanded Open a Project

Open the application that was created in Lesson 5 - Bind a Scheduler to MS SQL Database at Design Time of the current Getting Started tutorial.

Expanded Generate a Custom Appointment Edit Form

  1. Click the smart tag of the SchedulerControl to invoke the SchedulerControl Tasks menu. Click the Mapping Wizard... link in the Appointments section. In the Setup Appointment Storage window, you will see the standard property mappings that were automatically generated in the previous lesson. To specify custom data fields, click Next.

  2. Select the ContactInfo field in the left pane, and double-click it to move it to the right pane, or use the command button with a "greater than" sign .

    Change the custom field name to Contacts, or specify your own name. Click Finish.

  3. In the ShedulerControl Tasks menu, click the Create Custom Appointment Form item.

    In the Customize Appointments Form window that is invoked, select the Default layout and click OK.

    Tip

    If you select the OutlookStyle layout, the steps that follows are essentially the same (except those related to the layout itself).

  4. Open the CustomAppointmentForm in design mode. Drag and drop the LabelControl control and the MemoExEdit control from the DX.17.1: Common Controls Toolbox tab to the form.

    In the Properties window, set the Text property of LabelControl to Contacts:, and change the Name property of the MemoExEdit control to mxContacts.

  5. To add the capability to obtain a custom field value or set a custom appointment field, modify the LoadFormData(), SaveFormData() and IsAppointmentChanged() methods in the CustomAppointmentForm code file.

    Show Me

    A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=T342127.

Expanded Run the Project to See the Result

Run the application. The following image shows the Custom Appointment Edit Form invoked by double-clicking an appointment.

How would you rate this topic?​​​​​​​