Calendar Reference

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

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.