A newer version of this page is available. Switch to the current version.



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.

Default Statuses

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

Brush Type Display Name ID
WPFScheduler_Status_Free AppointmentStatusType.Free SchedulerStringId.Caption_Free 0
WPFScheduler_Status_Tentative AppointmentStatusType.Tentative SchedulerStringId.Caption_Tentative 1
WPFScheduler_Status_Busy AppointmentStatusType.Busy SchedulerStringId.Caption_Busy 2
WPFScheduler_Status_OutOfOffice AppointmentStatusType.OutOfOffice SchedulerStringId.Caption_OutOfOffice 3
WPFScheduler_Status_WorkingElsewhere.png AppointmentStatusType.WorkingElsewhere SchedulerStringId.Caption_WorkingElsewhere 4

You can edit this collection and customize the existing statuses, remove them, or add custom statuses.


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

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.

See Also