[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

The appointment's availability (busy) status ois an object that is used to categorize appointments. The status is indicated in the scheduler as a strip on an appointment rectangle's left side and is colored according to the status type.

The image below shows appointments with different statuses. An end-user can change the appointment's status in the context menu by clicking Show Time As.

A status is an AppointmentStatusItem class instance that is assigned to an appointment using the AppointmentItem.StatusId property. All statuses are contained in the SchedulerControl.StatusItems collection.

Expanded Default Statuses

The SchedulerControl.StatusItems collection includes the following statuses by default:

You can generate this XAML snippet by clicking the Create Status Items item in the scheduler's Smart Tag.

See the Appearance Customization topic for information on how to customize brushes associated with statuses.


Handle the SchedulerControl.InitNewAppointment event to initialize all newly created appointments with a specific status.

Expanded Binding to Data

Statuses can be bound to a data source using the DataSource.AppointmentStatusesSource property. Map data fields to status properties using the AppointmentStatusMappings settings.

Expanded See Also

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