Events

The RadCalendar component exposes the following events:

• DisplayDateChanged: Occurs when the current display date is changed. The DisplayDateChanged event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadCalendar type.
  • A ValueChangedEventArgs<object> object which provides both old and new values of the DisplayDate property. The values are of type object, but can be cast to the DateTime type.

• ViewChanged: Occurs when the calendar view mode is changed. The ViewChanged event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadCalendar type.
  • A ValueChangedEventArgs<CalendarViewMode> object which provides both old and new value of the ViewMode property. The values are of type CalendarViewMode.

• SelectionChanged: Occurs when the selected date is changed programmatically or due to user interaction. The SelectionChanged event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadCalendar type.
  • A ValueChangedEventArgs<object> object which provides old and new value of the SelectedDate. The values are of type object, but can be cast to the DateTime type. SelectionChanged event is fired on UWP in MonthView mode.

• MonthChanged: Occurs when the calendar month is changed in Month ViewMode.

  • The sender argument which is of type object, but can be cast to the RadCalendar type.
  • A ValueChangedEventArgs<object> object which provides both NewValue and PreviousValue. The values are of type object.

• TimeSlotTapped: Occurs when the end-user taps on a time slot.

  • The sender argument which is of type object, but can be cast to the RadCalendar type.
  • A TimeSlotTapEventArgs object which provides StartTime and EndTime properties of type DateTime that define the time slot.

• AppointmentTapped: Occurs when you tap over a specific appointment when in DayView/MultiDayView mode. It can be used to get all the information regarding the appointment.

  • The sender argument which is of type object, but can be cast to the RadCalendar type.
  • An AppointmentTappedEventArgs object which provides Appointment property. The Appointment is of type IAppointment and could be cast to the appointment implementation that is used in RadCalendar.

In addition, RadCalendar provides the following eventa relating to the native Calendar control renderer:

• NativeControlLoaded : Occurs when the renderer has finished preparing the native control.
• NativeControlUnloaded : Occurs when the native control is in invalid state.

Both event handlers receives two parameters:

• The sender argument which is of type object, but can be cast to the RadCalendar type.
• A System.EventArgs object.

With R3 2021 Service Pack Scheduling UIs exposes events for appointments changes: AppointmentAdded, AppointmentUpdated and AppointmentDeleted events. For more details check the SchedulingUI Events article.

See Also

• Date Properties
• View Modes
• Appointments