[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
   [Expand]Getting Started
    Time Regions
   [Expand]Visual Elements
   [Expand]Styles and Templates
   [Expand]Design-Time Features
    Time Zones
   [Expand]Data Binding
    Appearance Customization
    Clipboard Operations
    Printing Templates
    Drag and Drop Customization
    End-User Restrictions
    Migration Guidelines
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


Expanded Overview

An appointment is an activity scheduled for a specific time interval. An activity is characterized by its subject, location, category (Label), status (Status) and description. An appointment may also contain custom properties. Appointments can be recurring, which means that an activity can be scheduled to repeat at specified time intervals.

The scheduler displays an appointment as a color rectangle with text and graphics elements, as illustrated in the picture below.

An AppointmentItem object represents an appointment, and the the active View, which is used to show the Scheduler's data, determines its visual representation.

Expanded Appointment Types

Appointments are of several types, indicated by the AppointmentItem.Type property. A regular appointment type is AppointmentType.Normal. All appointment types are listed in the AppointmentType enumeration.

The following diagram illustrates the difference between recurring and non-recurring appointment types.

To learn more about recurring appointments and their types, see the Recurrence document.

Expanded Organizing Appointments

Appointments can be grouped by label and status. To extend appointment classification and enable tracking by different criteria, you can store additional information in appointment's Custom Fields.

Expanded Member Table

Member Description
AppointmentItem An appointment in the Scheduler.
SchedulerControl.AppointmentItems Provides access to the appointments in the scheduler.
SchedulerControl.GetAppointments Returns the collection of appointments for the specified time interval.
SchedulerControl.SelectedAppointments Provides access to the selected Appointments.
SchedulerControl.InitNewAppointment Occurs before a new AppointmentItem is created in the SchedulerControl.
SchedulerControl.AppointmentsUpdated Occurs after Scheduler appointments are updated.
SchedulerControl.GetAppointmentItemBySourceObject Gets a source object's associated appointment.
SchedulerControl.SelectedAppointmentsSource Gets or sets the object used as the selected appointments' source. This is a dependency property.

Is this topic helpful?​​​​​​​