RadControls for Silverlight

Represents a selection control that allows you to select dates from a calendar.

Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Input (in Telerik.Windows.Controls.Input.dll) Version: 2013.1.403.1050

Syntax

C#
public class RadCalendar : Control, 
	IThemable
Visual Basic
Public Class RadCalendar _
	Inherits Control _
	Implements IThemable

Remarks

The Calendar control allows the user to select a single date.

The user can navigate in the Calendar by clicking the arrow buttons in the calendar header that would cycle through the list of days, months or years. Clicking in-between the two arrows would change the DisplayMode of the calendar so that it displays a year if a month was displayed (The same applies for. Clicking the button with today's date would navigate to the month view of the current month.

The SelectionMode allows more than one date to be selected. There are three modes of selection - SelectionMode.Single, SelectionMode.Multiple and SelectionMode.Extended. Advanced keyboard selection - dragging while holding Ctrl or/and Shift is supported. The SelectedDates property is a list of all selected dates.

The DisplayMode property allows you to get or set the current display mode. By handling the DisplayModeChanged routed event you would receive a notification whenever a change in the display mode occurs.

Disabling or enabling the selection of dates can be controlled by the SelectableDateStart and SelectableDateEnd properties. If none of the latter two has been set, i.e. their value is null then all the calendar dates are selectable.

The SelectedDate property holds the DateTime value of the selected date. The default value is null (no date is selected). Adding a handler for the SelectedDate event would enable you to be notified whenever a date is selected.

Similarly, to modify which dates the user can navigate to, use the DisplayDateStart and DisplayDateEnd properties. Setting the DisplayDate property navigates the calendar to the month or year that contain this date (depending on the current DisplayMode). Please note that the DisplayDate property cannot be set to null.

The Calendar has more than 20 properties which allow you to set styles, style selectors, templates and template selectors for the different views and buttons of the Calendar. The Calendar help articles provide more information on the control parts and template structures.

Please note that the RadCalendar currently supports only Gregorian calendar.

Inheritance Hierarchy

System..::..Object
  System.Windows..::..DependencyObject
    System.Windows..::..UIElement
      System.Windows..::..FrameworkElement
        System.Windows.Controls..::..Control
          Telerik.Windows.Controls..::..RadCalendar

See Also