CalendarExtender Server Reference
The Calendar control extender can be attached to any ASP.NET TextBox control. It provides client-side
date-picking functionality with customizable date format and UI in a popup control. You can interact
with the calendar by clicking on a day to set the date, or the "Today" link to set the current date.
In addition, the left and right arrows can be used to move forward or back a month.
By clicking on the title of the calendar you can change the view from Days in the current month,
to Months in the current year. Another click will switch to Years in the current Decade.
This action allows you to easily jump to dates in the past or the future from within
the calendar control.
CalendarExtender Server Properties
| Name | Description |
|---|
| Animated |
Whether changing modes is animated
|
| ClearTime |
Whether time should be cleared in edited date/time
|
| CssClass |
Name of the Cascading Style Sheet class used to style the calendar
|
| DaysModeTitleFormat |
Format string used to display Days Mode Title. The default value is "MMMM, yyyy"
|
| DefaultView |
Gets or sets the default view of the calender. The default value is Days.
|
| EnabledOnClient |
Whether this behavior is available for the current element
|
| FirstDayOfWeek |
Gets or sets the first day of week
|
| Format |
Format string used to display the selected date. The default value is "d"
|
| OnClientDateSelectionChanged |
Gets or sets the script that executes when a new date is selected
|
| OnClientHidden |
Gets or sets the client script that executes immediately after the calendar is hidden
|
| OnClientHiding |
Gets or sets the client script that executes immediately before the calendar is hidden
|
| OnClientShowing |
Gets or sets the client script that executes immediately before the calendar is displayed
|
| OnClientShown |
Gets or sets the client script that executes immediately after the calendar is displayed
|
| PopupButtonID |
The ID of a control to show the calendar popup when clicked. If this value is not set, the calendar will pop up when the textbox receives focus
|
| PopupPosition |
Gets or sets the popup position of the calendar. The default value is BottomLeft
|
| SelectedDate |
Gets or sets the date that the calendar is initialized with
|
| TodaysDateFormat |
Format string used to display today's date. The default value is "MMMM d, yyyy"
|
CalendarBehavior Client Reference
CalendarBehavior Client Properties
| Name | Description |
|---|
| animated |
Whether changing modes is animated
|
| button | The button to use to show the calendar (optional) |
| clearTime |
Whether time should be cleared in edited date/time
|
| cssClass | The CSS class selector to use to change the calendar's appearance |
| dayCell | Gets the day cell at the specified row or column |
| daysModeTitleFormat | The format to use for the title when in days mode |
| defaultView | The default view of the calendar when it first pops up. |
| enabled | Whether this behavior is available for the current element |
| firstDayOfWeek | The day of the week to appear as the first day in the calendar |
| format | The format to use for the date value |
| isOpen | Whether the calendar is open |
| popupPosition | Where the popup should be positioned relative to the target control.
Can be BottomLeft (Default), BottomRight, TopLeft, TopRight. |
| selectedDate | The date value represented by the text box |
| todayButton | The button used to select todays date |
| todaysDate | The date to use for "Today" |
| todaysDateFormat | The format to use for the todays date |
| visibleDate |
The date currently visible in the calendar
|
CalendarBehavior Client Methods
| Name | Description |
|---|
| blur | |
| dispose |
Disposes this behavior's resources
|
| focus | |
| hide |
Hides the calendar
|
| initialize |
Initializes the components and parameters for this behavior
|
| invalidate |
Performs layout of the behavior unless layout is suspended
|
| raiseDateSelectionChanged |
Raise the dateSelectionChanged event
|
| raiseHidden |
Raise the hidden event
|
| raiseHiding |
Raise the hiding event
|
| raiseShowing |
Raise the showing event
|
| raiseShown |
Raise the shown event
|
| resumeLayout |
Resumes layout of the behavior and performs any pending layout requests
|
| show |
Shows the calendar
|
| suspendLayout |
Suspends layout of the behavior while setting properties
|
CalendarBehavior Client Events
| Name | Description |
|---|
| dateSelectionChanged |
Adds an event handler for the dateSelectionChanged event.
|
| hidden |
Adds an event handler for the hidden event.
|
| hiding |
Adds an event handler for the hiding event.
|
| showing |
Adds an event handler for the showiwng event.
|
| shown |
Adds an event handler for the shown event.
|