Home / AJAX

Calendar Reference

RSS
Modified on 2010/05/06 16:12 by Stephen Walther Categorized as Uncategorized

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

NameDescription
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

NameDescription
animated Whether changing modes is animated
buttonThe button to use to show the calendar (optional)
clearTime Whether time should be cleared in edited date/time
cssClassThe CSS class selector to use to change the calendar's appearance
dayCellGets the day cell at the specified row or column
daysModeTitleFormatThe format to use for the title when in days mode
defaultViewThe default view of the calendar when it first pops up.
enabledWhether this behavior is available for the current element
firstDayOfWeekThe day of the week to appear as the first day in the calendar
formatThe format to use for the date value
isOpenWhether the calendar is open
popupPositionWhere the popup should be positioned relative to the target control. Can be BottomLeft (Default), BottomRight, TopLeft, TopRight.
selectedDateThe date value represented by the text box
todayButtonThe button used to select todays date
todaysDateThe date to use for "Today"
todaysDateFormatThe format to use for the todays date
visibleDate The date currently visible in the calendar

CalendarBehavior Client Methods

NameDescription
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

NameDescription
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.