ASPxCalendar Overview

• Aug 01, 2019
• 3 minutes to read

The ASPxCalendar control allows end users to select dates and navigate through months and years.

Main Features

• Multiple Date Selection

  End users can work in single or multiple date selection mode (ASPxCalendar.EnableMultiSelect). In multiple date selection mode, end users can select individual dates or a range of dates. To select a range of dates, select the initial date and hold the left mouse button down or Shift while moving the mouse to the final date. Hold down Ctrl to add/remove a date from the selection. Click a week number to select the entire week.

• Highlight Dates

  The ASPxCalendar.HighlightToday and ASPxCalendar.HighlightWeekends properties allow you to highlight today’s date and weekend days.

• Customizable Appearance

  

  The following table provides API members you can use to customize the Calendar’s appearance:

  Element	Visibility	Appearance
  Today Button	ASPxCalendar.ShowTodayButton	ASPxCalendar.ButtonStyle
  Clear Button	ASPxCalendar.ShowClearButton	ASPxCalendar.ButtonStyle
  Week Numbers	ASPxCalendar.ShowWeekNumbers	ASPxCalendar.WeekNumberStyle
  Day Headers	ASPxCalendar.ShowDayHeaders	ASPxCalendar.DayHeaderStyle
  Header	ASPxCalendar.ShowHeader	ASPxCalendar.HeaderStyle
  Month Navigation Buttons	ASPxCalendar.EnableMonthNavigation	ASPxCalendar.NextMonthImage, ASPxCalendar.PrevMonthImage
  Year Navigation Buttons	ASPxCalendar.EnableYearNavigation	ASPxCalendar.NextYearImage, ASPxCalendar.PrevYearImage

• Multi-Month View

  The Calendar control can display multiple months and organize them in several rows and columns. The ASPxCalendar.Columns and ASPxCalendar.Rows properties enable you to define the number of columns and rows. (Show Online Demo)

  

• Month-Year Picker Mode

  The Month-year Picker mode allows you to specify which date component an end user can select: a day, a month or a year. You can click the header to change the calendar view (fast navigation). Use the following settings to specify the date selection and restrict the available calendar views:

  Property	Description
  PickerType	Specifies a date component an end user can select (a day, month or year).
  FastNavProperties.InitialZoomLevel	Specifies the initial Calendar view.
  FastNavProperties.MaxZoomLevel	Specifies the earliest available Calendar view. For example, if the CalendarFastNavProperties.MaxView property is set to “Months”, the picker displays the months of a particular year and January is the earliest available Calendar view item.

• Inline Navigation

  The Calendar can display the fast navigation panel in the editor or popup window (CalendarFastNavProperties.DisplayMode).

  

• Custom Day Rendering

  You can customize each calendar day’s appearance before the browser renders a page. (Show Online Demo)

• Built-in Validation

  The Calendar control allows you to validate the data on the client and server side. Refer to the Validation topic for more information.

• Client-Side APIs

  The ASPxClientCalendar object serves as the ASPxCalendar control’s client-side equivalent and provides client-side APIs.

  Use the following methods to modify the editor’s behavior:

  Method	Description
  ASPxClientCalendar.ClearSelection	Deselects all the selected dates.
  ASPxClientCalendar.DeselectDate	Deselects the specified date.
  ASPxClientCalendar.DeselectRange	Deselects the range of dates.
  ASPxClientCalendar.GetMaxDate	Gets the earliest date an end-user can select..
  ASPxClientCalendar.GetMinDate	Gets the furthest date an end-user can select.
  ASPxClientCalendar.GetSelectedDate	Returns the selected date.
  ASPxClientCalendar.SetSelectedDate	Sets the calendar’s selected date.
  ASPxClientCalendar.GetSelectedDates	Gets a list of selected dates.
  ASPxClientCalendar.GetVisibleDate	Gets the date (day, month, year) that the calendar displays.
  ASPxClientCalendar.IsDateSelected	Specifies whether the specified date is selected.
  ASPxClientCalendar.SelectDate	Selects the specified date.
  ASPxClientCalendar.SelectRange	Selects the specified range of dates.
  ASPxClientCalendar.SetMaxDate	Sets the calendar’s furthest date an end user can select.
  ASPxClientCalendar.SetMinDate	Sets the calendar’s earliest date an end user can select.
  ASPxClientCalendar.SetSelectedDate	Sets the calendar’s selected date.
  ASPxClientCalendar.SetVisibleDate	Sets the date (day, month, year) the calendar displays.