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
   [Expand]Getting Started
   [Expand]Fundamentals
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Collapse]Examples
    [Expand]Appearance
    [Expand]Data Binding
    [Expand]Data Exchange
    [Expand]DateTime
    [Expand]DateNavigator
    [Expand]Forms
    [Expand]Gantt View
    [Expand]Initialization
    [Expand]Labels and Statuses
    [Expand]Layout
    [Expand]Menu
    [Expand]Printing and Reporting
    [Expand]Protection
    [Expand]Range Control
    [Expand]Recurrence
    [Expand]Reminders
    [Collapse]Selection
      How to: Determine which Scheduler Element Is Hovered by the Mouse Pointer
      How to: Obtain Selected Appointments
      How to: Create an Appointment for the Currently Selected Time Interval and Resource
      How to: Split Appointments and Series
   [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

How to: Split Appointments and Series

This document describes a tool that enables users to split an appointment in two by dragging a splitter line over it. This is especially convenient if you need to divide recurring appointments. All you have to do is to select a Split command in the context menu of the selected appointment, position a splitter at the required time and click the left mouse button.

The following pictures illustrate what the splitter looks like in different Scheduler views:

DayView

Timeline View

By executing the Split command, you enter the Split mode of the Scheduler. In this mode, all user input is directed to the command handler. You have the option to specify the time at which the appointment should be split or cancel the operation.

The split time is indicated in the tooltip, along with the time resolution of a splitter movement. The resolution is set automatically according to the appointment's duration and varies from one hour to one minute. You can adjust it manually using the mouse wheel.

Clicking the right mouse button or pressing ESC leaves the Split mode and restores normal operation.

The following illustrations show the Scheduler before and after the split operation is applied to a recurring appointment.

Before:

After:

The series is split into two independent series of recurring appointments, with the end time of the first series being equal to the start time of the next series.

The tool is activated by the DevExpress.XtraScheduler.Commands.SplitAppointmentOperationCommand. You can associate this command with the context menu item, as illustrated in the CodeCentral example available online: How to split appointment.

Handle the SchedulerControl.PreparePopupMenu event to add a menu item which executes the command and invokes the Split tool:

Show Me

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

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