Calendar Documentation - Common

Properties - styles

StyleFolder Path to the folder with style to use. Optional

Properties - Appearance settings

MonthWidth Width of each month in pixels. Default is 250. Optional MonthHeight Height of each month in pixels. Default is 170. Optional MonthMarginWidth Width of the margin between months. Default is 10. Optional Columns Number of columns in the calendar. Default is 2. Optional Rows Number of rows in the calendar. Default is 1. Optional TitleText The text that will be shown in the title of the calendar between left and right arrows. Default value is today's date. Optional ShowYearSelector Displays a drop-down list or a html list of years. It depends on the value of the property YearSelectorType. By default, it takes ±10 years from current year. If DateMin and DateMax are defined, then the range is taken from those values. If only one of these properties is defined, then that value is used and the second is ±10 years from current year. Optional YearSelectorType Specifies the year selector type. Available values are HtmlList and DropDownList. Default value is HtmlList.Optional ShowTimeSelector Displays a drop-down list for hours, for minutes and for seconds. Optional TextArrowLeft Any text or HTML for left arrow. Default value: <<. Optional TextArrowRight Any text or HTML for right arrow. Default value: >>. Optional ShowOtherMonthDays If true, then dates for previous and next months are shown in the main month. Default is true. Optional

Properties - settings

Speed Scrolling speed. Default value: 25. Optional ScrollBy Number of columns to scroll by. If this value is more than number of columns defined in Columns, then calendar scrolls by blocks of months. For example, if calendar has Columns=2, Rows=2 and ScrollBy=4,then view of January-April would change to May-August. Optional DateToday A DateTime value representing today's date. Optional Default value is today's date on the server. DateFirstMonth A DateTime value representing the first month to show in the calendar. If not defined, then the value from DateToday is used. Optional DateMin Minimum date allowed. Any date lower than this is disabled. Optional YearMinScroll Minimum year visible without using the scroll. Any year lower than this is visible when scrolling, inside DateMin, DateMax range. Optional DateMax Maximum date allowed. Any date greater than this is disabled. Optional YearMaxScroll Maximum year visible without using the scroll. Any year bigger than this is visible when scrolling, inside DateMin, DateMax range. Optional SelectedDate Changes when new date is selected and postback occured. You can also set it to any DateTime value initially. AllowDeselect When true, selected date can be deselected. Default value: true. Optional AllowSelectSpecial When true, special dates can be selected. Default value: true. Optional AllowSelectRegular Specifies whether regular dates can be selected. Default value: true. Optional YearSelectorScrollSpeed Specifies the scolling speed of the year selector. Default value: 100 (milliseconds). Optional FirstYearSelectorScrollSpeed Specifies the amount of time till the year selector is starting to scroll. Default value: 0 (milliseconds). Optional

Properties - date picker mode only

DatePickerMode A true/false value. When true, calendar is in date picker mode. Default value: false. TextBoxId ID of a textbox where to show the selected date. DatePickerImagePath Path to the image to be used as date picker button. Optional Example: "/calendar/styles/icon2.gif" Enabled Specify whether calendar should be enabled or not. Default value: true. Optional Align Specify the position where calendar is displayed when in date picker mode. Available values are Cursor, Left, Right, Above, Under. Default value: Cursor. Optional Check the Date picker align tutorial BeginDateCalendarId The ID of another calendar to be used as a starting date. When you want to select a range of dates (airline tickets, for example) you can create the first calendar, then in the second one you specify BeginDateCalendarId with ID of the first. The calendars will work together then. Optional Check the Date Range tutorial

Globalization

CultureName Sets the culture name that will be used. Default is "en-US". Optional

Methods

AddSpecialDate Adds a new special date. Overloaded methods: AddSpecialDate(DateTime Date) AddSpecialDate(DateTime Date, string ToolTip) AddSpecialDate(DateTime Date, string ToolTip, string CSSClass) AddSpecialDate(DateTime Date, string ToolTip, string CSSClass, string Url) AddSpecialDate(int Year, int Month, int Day) AddSpecialDate(int Year, int Month, int Day, string Tooltip) AddSpecialDate(int Year, int Month, int Day, string Tooltip, string CSSClass) AddSpecialDate(int Year, int Month, int Day, string Tooltip, string CSSClass, string Url) Date - a DateTime object Year - year of this special date. Month - month of this special date. Day - day of this special date. Tooltip - tooltip to display on mouse over. CssClass - css class for the special date. Url - URL to open when clicked on special date.

Please visit HOW-TO and Help page for any questions.

"The grid itself is excellent. I'm amazed by what you have accomplished with it. It has become the main control for our pages due to our customers responses to layouts with it." Mark Butler Achieve Technology