Telerik.Web.UI.RadCalendar
Inheritance Hierarchy
- System.Object
- System.Web.UI.Control
- System.Web.UI.WebControls.WebControl
- Telerik.Web.UI.RadWebControl : IControl, IControlResolver, IPostBackDataHandler, IScriptControl, ISkinnableControl
- Telerik.Web.UI.Calendar.Persistence.PropertiesControl : IStateManager
- Telerik.Web.UI.RadCalendar : INamingContainer, IPostBackEventHandler
Properties
AutoPostBack Boolean
Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control.
Remarks
Setting this property to true will make Telerik RadCalendar postback to the server on date selection or when navigating to a different month.
Calendar Calendar
Gets the default System.Globalization.Calendar instance as specified by the default culture.
Remarks
A calendar divides time into measures, such as weeks, months, and years. The number, length, and start of the divisions vary in each calendar.Any moment in time can be represented as a set of numeric values using a particular calendar. For example, the last vernal equinox occurred at (0.0, 0, 46, 8, 20, 3, 1999) in the Gregorian calendar. An implementation of Calendar can map any DateTime value to a similar set of numeric values, and DateTime can map such sets of numeric values to a textual representation using information from Calendar and DateTimeFormatInfo. The textual representation can be culture-sensitive (for example, "8:46 AM March 20th 1999 AD" for the en-US culture) or culture-insensitive (for example, "1999-03-20T08:46:00" in ISO 8601 format).A Calendar implementation can define one or more eras. The Calendar class identifies the eras as enumerated integers where the current era (CurrentEra) has the value 0.In order to make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days than a standard calendar year. Each Calendar implementation defines leap years differently.For consistency, the first unit in each interval (for example, the first month) is assigned the value 1.The System.Globalization namespace includes the following Calendar implementations: GregorianCalendar, HebrewCalendar, HijriCalendar, JapaneseCalendar, JulianCalendar, KoreanCalendar, TaiwanCalendar, and ThaiBuddhistCalendar.
CalendarCaption Calendar
Gets or sets a value for RadCalendar caption.
Remarks
Setting this property to empty string will force Telerik RadCalendar to not render caption tag
CalendarDayTemplates CalendarDayTemplateCollection
Gets or sets a collection of type
CalendarDayTemplateCollection which stores the created templates to use with
RadCalendar. All of the
items are represented by
DayTemplate
instances.
CalendarSummary Calendar
Gets or sets a value for RadCalendar summary.
Remarks
Setting this property to empty string will force Telerik RadCalendar to not render summary attribute
CalendarTableStyle Calendar
Gets the style properties for the Calendar table container.
CalendarView Calendar
Exposes the top instance of CalendarView or its derived types.Every CalendarView class handles the real calculation and rendering of RadCalendar's calendric information. The CalendarView has the
ChildViews collection which contains all the sub views in case of multi view
setup.
CellAlign HorizontalAlign
Gets or sets the horizontal alignment of the date cells content inside the calendar area.The HorizontalAlign enumeration is defined in System.Web.UI.WebControls
Remarks
Member nameDescriptionCenterThe contents of a container are centered.JustifyThe contents of a container are uniformly spread out and aligned with both the left and right margins.LeftThe contents of a container are left justified.NotSetThe horizontal alignment is not set.RightThe contents of a container are right justified.
CellDayFormat String
Gets or sets the format string that will be applied to the dates presented in the calendar area.
Remarks
For additional details see Date Format Pattern topic
CellVAlign VerticalAlign
Gets or sets the vertical alignment of the date cells content inside the calendar area.The VerticalAlign enumeration is defined in System.Web.UI.WebControls
Remarks
Member nameDescriptionBottomText or object is aligned with the bottom of the enclosing control.MiddleText or object is aligned with the center of the enclosing control.NotSetVertical alignment is not set.TopText or object is aligned with the top of the enclosing control.
ClientEvents CalendarClientEvents
Gets the instance of
CalendarClientEvents class which defines the JavaScript functions (client-side
event handlers) that are invoked when specific client-side events are raised.
ClientIDMode ClientIDMode
This property is overridden in order to support controls which implement INamingContainer. The default value is changed to "AutoID".
ColumnHeaderImage String
Gets or sets the image displayed for the column header element.
Remarks
This property applies only if the ShowColumnHeaders property is set to true. If ColumnHeaderText is set too, its value is set as an alternative text to the image of the column header.When using this property, the whole image URL is generated using also the ImagesBaseDir value.Example:ShowColumnHeaders="true"ImagesBaseDir = "Img/"ColumnHeaderImage = "selector.gif"complete image URL : "Img/selector.gif"
ColumnHeaderText String
Gets or sets the text displayed for the column header element.
Remarks
Use the ColumnHeaderText property to provide custom text
for the CalendarView complete column header element.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the ColumnHeaderText property. For
example, if you want to display an image for the next month navigation control, you
can set this property to an expression that contains an
element.This property applies only if the ShowColumnHeaders
property is set to true.
CssClass String
Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.
CssClassFormatString String
The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()
CssFile String
Gets or sets the name of the file containing the CSS definition used by RadCalendar. Use "~/" (tilde) as a substitution of the web-application root directory.
CultureInfo CultureInfo
Gets or sets the CultureInfo instance that represents information about the culture of this RadCalendar object.A CultureInfo class describes information about the culture of this RadCalendar instance including the names of the culture, the writing system, and the calendar used, as well as access to culture-specific objects that provide methods for common operations, such as formatting dates and sorting strings.
Remarks
The culture names follow the RFC 1766 standard in the format
"
DateRangeSeparator String
Gets or sets the separator string that will be put between start and end months in a multi view title.
DateTimeFormat DateTimeFormatInfo
Gets or sets a DateTimeFormatInfo instance that defines the culturally appropriate format of displaying dates and times as specified by the default culture.
Remarks
A DateTimeFormatInfo can be created only for the invariant culture or for specific cultures, not for neutral cultures.The cultures are generally grouped into three sets: the invariant culture, the neutral cultures, and the specific cultures.The invariant culture is culture-insensitive. You can specify the invariant culture by name using an empty string ("") or by its culture identifier 0x007F. InvariantCulture retrieves an instance of the invariant culture. It is associated with the English language but not with any country/region. It can be used in almost any method in the Globalization namespace that requires a culture. If a security decision depends on a string comparison or a case-change operation, use the InvariantCulture to ensure that the behavior will be consistent regardless of the culture settings of the system. However, the invariant culture must be used only by processes that require culture-independent results, such as system services; otherwise, it produces results that might be linguistically incorrect or culturally inappropriate.A neutral culture is a culture that is associated with a language but not with a country/region. A specific culture is a culture that is associated with a language and a country/region. For example, "fr" is a neutral culture and "fr-FR" is a specific culture. Note that "zh-CHS" (Simplified Chinese) and "zh-CHT" (Traditional Chinese) are neutral cultures.The user might choose to override some of the values associated with the current culture of Windows through Regional and Language Options (or Regional Options or Regional Settings) in Control Panel. For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.If UseUserOverride is true and the specified culture matches the current culture of Windows, the CultureInfo uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, the properties of the NumberFormatInfo instance returned by the NumberFormat property, and the properties of the CompareInfo instance returned by the CompareInfo property. If the user settings are incompatible with the culture associated with the CultureInfo (for example, if the selected calendar is not one of the OptionalCalendars ), the results of the methods and the values of the properties are undefined.Note: In this version of RadCalendar the NumberFormatInfo instance returned by the NumberFormat property is not taken into account.
DayCellToolTipFormat String
Gets or sets the format string that is applied to the days cells tooltip.
Remarks
The property should contain either a format specifier character or a custom format pattern. For more information, see the summary page for System.Globalization.DateTimeFormatInfo.By default this property uses formatting string of 'dddd, MMMM dd, yyyy'. Valid formats are all supported by the .NET Framework.Example:"d" is the standard short date pattern."%d" returns the day of the month; "%d" is a custom pattern."d " returns the day of the month followed by a white-space character; "d " is a custom pattern.
DayNameFormat DayNameFormat
Specifies the display formats for the days of the week used as selectors by RadCalendar.
Remarks
Use the DayNameFormat property to specify the name format for the days of the week. This property is set with one of the DayNameFormat enumeration values. You can specify whether the days of the week are displayed as the full name, short (abbreviated) name, first letter of the day, or first two letters of the day.The DayNameFormat enumeration represents the display formats for the days of the week used as selectors by RadCalendar.Member nameDescriptionFirstLetterThe days of the week displayed with just the first letter. For example, T.FirstTwoLettersThe days of the week displayed with just the first two letters. For example, Tu.FullThe days of the week displayed in full format. For example, Tuesday.ShortThe days of the week displayed in abbreviated format. For example, Tues.
DayOverStyle TableItemStyle
Gets the style properties applied when hovering over the Calendar days.
DayStyle TableItemStyle
Gets the style properties for the days in the displayed month.
DaysViewSummary String
Gets or sets a value for DaysView summary.
Remarks
Setting this property to empty string will force Telerik RadCalendar to not render summary attribute for the DaysView.
DefaultCellPadding Int32
Gets or sets the cell padding of the table where are rendered the calendar days.
DefaultCellSpacing Int32
Gets or sets the cell spacing of the table where are rendered the calendar days.
DisabledDayStyle TableItemStyle
Gets the style properties for the disabled dates.
EnableAjaxSkinRendering String
Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests
Remarks
If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.
EnableAriaSupport Boolean
When set to true enables support for WAI-ARIA
EnableEmbeddedBaseStylesheet Boolean
Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.
Remarks
If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.
EnableEmbeddedScripts Boolean
Gets or sets the value, indicating whether to render script references to the embedded scripts or not.
Remarks
If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.
EnableEmbeddedSkins String
Gets or sets the value, indicating whether to render links to the embedded skins or not.
Remarks
If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.
EnableKeyboardNavigation Boolean
Gets or sets the enable client side navigation with arrow keys.
EnableMonthYearFastNavigation Boolean
Gets or sets whether the month/year fast navigation controls in the title section will be enabled.
EnableMultiSelect Boolean
Allows the selection of multiple dates. If not set, only a single date is selected, and if any dates are all ready selected, they are cleared.
EnableNavigation Boolean
Gets or sets whether the navigation controls in the title section will be displayed.
EnableNavigationAnimation Boolean
Enables the animation shown when the calendar navigates to a different view.
EnableRepeatableDaysOnClient Boolean
Gets or sets whether the repeatable days logic should be supported on the client (effective for client calendar - with set property AutoPostBack="false").
Remarks
The EnableRepeatableDaysOnClient property has effect over the logic of the recurring events to the calendar. It should be true, if you wants the repeatable days to be supported by a calendar with AutoPostBack="false". If you are not using repeatable days or/and client calendar, you can improve the calendar performance by setting it to false.
EnableRippleEffect Boolean
Returns true if ripple effect should be added
EnableShadows Boolean
Gets or sets whether popup shadows will appear.
EnableViewSelector Boolean
Gets or sets whether a selector for the entire CalendarView ( MonthView ) will appear on the calendar.
EnableWeekends Boolean
Set this property to false if like to disable the selection of weekends. The default value is true.
FastNavigationNextImage String
Gets or sets the name of the image that is displayed for the next month fast navigation control.
Remarks
When using this property, the whole image URL is generated using also the ImagesBaseDir (if no skin is applied) or the SkinPath (if skin is applied) properties values. Example when skin is NOT defined:ImagesBaseDir = "Img/"RowSelectorImage = "nav.gif"complete image URL : "Img/nav.gif"Example when skin is defined:SkinPath = "RadControls/Calendar/Skins/"RowSelectorImage = "nav.gif"complete image URL : "RadControls/Calendar/Skins/nav.gif"
FastNavigationNextText String
Gets or sets the text displayed for the fast navigation next month control. Will be applied if there is no image set (see FastNavigationNextImage).
Remarks
Use the FastNavigationNextText property to provide custom text for
the next month navigation element in the title section of
RadCalendar.Note that the FastNavigationNextImage has priority
and its value should be set to an empty string in order to be applied the
FastNavigationNextText value.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the FastNavigationNextText property. For
example, if you want to display an image for the next month navigation control, you
can set this property to an expression that contains an
element. However note that
FastNavigationNextImage
property is available for this type of functionality.This property applies only if the EnableNavigation property
is set to true.
FastNavigationNextToolTip String
Gets or sets the text displayed as a tooltip for the fast navigation next month control.
Remarks
Use the FastNavigationNextToolTip property to provide custom text for the tooltip of the fast navigation next month element in the title section of RadCalendar.
FastNavigationPrevImage String
Gets or sets the name of the image that is displayed for the previous month fast navigation control.
Remarks
When using this property, the whole image URL is generated using also the ImagesBaseDir (if no skin is applied) or the SkinPath (if skin is applied) properties values. Example when skin is NOT defined:ImagesBaseDir = "Img/"RowSelectorImage = "nav.gif"complete image URL : "Img/nav.gif"Example when skin is defined:SkinPath = "RadControls/Calendar/Skins/"RowSelectorImage = "nav.gif"complete image URL : "RadControls/Calendar/Skins/nav.gif"
FastNavigationPrevText String
Gets or sets the text displayed for the fast navigation previous month control. Will be applied if there is no image set (see FastNavigationPrevImage).
Remarks
Use the FastNavigationPrevText property to provide custom text for
the next month navigation element in the title section of
RadCalendar.Note that the FastNavigationPrevImage has priority
and its value should be set to an empty string in order to be applied the
FastNavigationPrevText value.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the FastNavigationPrevText property. For
example, if you want to display an image for the next month navigation control, you
can set this property to an expression that contains an
element. However note that
FastNavigationPrevImage
property is available for this type of functionality.This property applies only if the EnableNavigation property
is set to true.
FastNavigationPrevToolTip String
Gets or sets the text displayed as a tooltip for the fast navigation previous month control.
Remarks
Use the FastNavigationPrevToolTip property to provide custom text for the tooltip of the fast navigation previous month element in the title section of RadCalendar.
FastNavigationSettings MonthYearFastNavigationSettings
Gets or sets the MonthYearFastNavigationSettings object whose inner properties can be used to modify the fast Month/Year client navigation settings.
FastNavigationStep Int32
Gets or sets an integer value representing the number of CalendarView views that will be scrolled when the user clicks on a fast navigation link.
FastNavigationStyle TableItemStyle
Gets the style properties for the Month/Year fast navigation.
FirstDayOfWeek FirstDayOfWeek
Specifies the day to display as the first day of the week on the RadCalendar control.The FirstDayOfWeek enumeration can be found in System.Web.UI.WebControls Namespace.
Remarks
The FirstDayOfWeek enumeration represents the values that specify which day to display as the first day of the week on the RadCalendar control.Member nameDescriptionDefaultThe first day of the week is specified by the system settings.FridayThe first day of the week is Friday.MondayThe first day of the week is Monday.SaturdayThe first day of the week is Saturday.SundayThe first day of the week is Sunday.ThursdayThe first day of the week is Thursday.TuesdayThe first day of the week is Tuesday.WednesdayThe first day of the week is Wednesday.
FocusedDate DateTime
Gets or sets the value that is used by RadCalendar to determine the viewable area displayed .
Remarks
By default, the FocusedDate property returns the current system date when in runtime, and in design mode defaults to System.DateTime.MinValue. When the FocusedDate is set, from that point, the value returned by the FocusedDate property is the one the user sets.
FocusedDateColumn DateTime
Gets or sets the column index where the FocusedDate (and the month view it belongs to) will be positioned inside a multi view area.
FocusedDateRow DateTime
Gets or sets the row index where the FocusedDate (and the month view it belongs to) will be positioned inside a multi view area.
FooterTemplate ITemplate
Gets or sets the System.Web.UI.ITemplate that defines how the footer section of the RadCalendar control is displayed.
Remarks
Footer section of the RadCalendar control is displayed under the main calendar area (the section that displays the dates information).Use this property to create a template that controls how the footer section of a RadCalendar control is displayed.CAUTION This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Validation Server Controls in MSDN.
HeaderStyle TableItemStyle
Gets the style properties for the row and column headers.
HeaderTemplate ITemplate
Gets or sets the System.Web.UI.ITemplate that defines how the header section of the RadCalendar control is displayed.
Remarks
Header section of the RadCalendar control is displayed under the title section and above the main calendar area (the section that displays the dates information).Use this property to create a template that controls how the header section of a RadCalendar control is displayed.CAUTION This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Validation Server Controls in MSDN.
HideNavigationControls Boolean
Gets or sets a value indicating whether the navigation control should be visible when disabled.
Remarks
Setting this property to true will hide the navigation controls when they are disabled
ImagesPath String
Gets or sets default path for the grid images when EnableEmbeddedSkins is set to false.
IsDesignMode Boolean
Returns whether RadCalendar is currently in design mode.
IsSkinSet String
For internal use.
KeyboardNavigationSettings KeyboardNavigationSettings
Used to define keyboard shortcut to focus the RadCalendar's main table.
LocalizationPath CalendarStrings
Gets or sets a value indicating where RadCalendar will look for its .resx localization file. By default this file should be in the App_GlobalResources folder. However, if you cannot put the resource file in the default location or .resx files compilation is disabled for some reason (e.g. in a DotNetNuke environment), this property should be set to the location of the resource file.
Remarks
If specified, the LocalizationPath property will allow you to load the grid localization file from any location in the web application.
MonthLayout MonthLayout
Gets or sets the predefined pairs of rows and columns, so that the product of the two values is exactly 42, which guarantees valid calendar layout. It is applied on a single view level to every MonthView instance in the calendar.
Remarks
The following values are applicable and defined in the MonthLayout enumeration: Layout_7columns_x_6rows - horizontal layout Layout_14columns_x_3rows - horizontal layout Layout_21columns_x_2rows - horizontal layout Layout_7rows_x_6columns - vertical layout, required when UseDaysAsSelectors is true and Orientation is set to
RenderInColumns.
Layout_14rows_x_3columns - vertical layout, required when
UseDaysAsSelectors
is true and
Orientation
is set to
RenderInColumns.
Layout_21rows_x_2columns - vertical layout, required when
UseDaysAsSelectors
is true and
Orientation
is set to
RenderInColumns.
MultiViewColumns Int32
Gets or sets the the count of columns to be displayed by a multi month CalendarView.
MultiViewRows Int32
Gets or sets the the count of rows to be displayed by a multi month CalendarView.
NavigationCaption String
Gets or sets a value for navigation controls caption.
Remarks
Setting this property to empty string will force Telerik RadCalendar to not render caption tag
NavigationCellPadding Int32
Gets or sets the cell padding that is applied to the title table.
NavigationCellSpacing Int32
Gets or sets the cell spacing that is applied to the title table.
NavigationNextImage String
Gets or sets the name of the image that is displayed for the next month navigation control.
Remarks
When using this property, the whole image URL is generated using also the ImagesBaseDir (if no skin is applied) or the SkinPath (if skin is applied) properties values. Example when skin is NOT defined:ImagesBaseDir = "Img/"RowSelectorImage = "nav.gif"complete image URL : "Img/nav.gif"Example when skin is defined:SkinPath = "RadControls/Calendar/Skins/"RowSelectorImage = "nav.gif"complete image URL : "RadControls/Calendar/Skins/nav.gif"
NavigationNextText String
Gets or sets the text displayed for the next month navigation control. Will be applied if there is no image set (see NavigationNextImage).
Remarks
Use the NavigationNextText property to provide custom text for the
next month navigation element in the title section of
RadCalendar.Note that the NavigationNextImage has priority and
its value should be set to an empty string in order to be applied the
NavigationNextText value.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the NavigationNextText property. For example,
if you want to display an image for the next month navigation control, you can set
this property to an expression that contains an
element. However note that
NavigationNextImage
property is available for this type of functionality.This property applies only if the EnableNavigation property
is set to true.
NavigationNextToolTip String
Gets or sets the text displayed as a tooltip for the next month navigation control.
Remarks
Use the NavigationNextToolTip property to provide custom text for the tooltip of the next month navigation element in the title section of RadCalendar.
NavigationPrevImage String
Gets or sets name of the image that is displayed for the previous month navigation control.
Remarks
When using this property, the whole image URL is generated using also the ImagesBaseDir (if no skin is applied) or the SkinPath (if skin is applied) properties values. Example when skin is NOT defined:ImagesBaseDir = "Img/"RowSelectorImage = "nav.gif"complete image URL : "Img/nav.gif"Example when skin is defined:SkinPath = "RadControls/Calendar/Skins/"RowSelectorImage = "nav.gif"complete image URL : "RadControls/Calendar/Skins/nav.gif"
NavigationPrevText String
Gets or sets the text displayed for the previous month navigation control. Will be applied only if there is no image set (see NavigationPrevImage).
Remarks
Use the NavigationPrevText property to provide custom text for the
previous month navigation element in the title section of
RadCalendar.Note that the NavigationPrevImage has priority and
its value should be set to an empty string in order to be applied the
NavigationPrevText value.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the NavigationPrevText property. For example,
if you want to display an image for the next month navigation control, you can set
this property to an expression that contains an
element. However note that
NavigationPrevImage
property is available for this type of functionality.This property applies only if the EnableNavigation property
is set to true.
NavigationPrevToolTip String
Gets or sets the text displayed as a tooltip for the previous month navigation control.
Remarks
Use the NavigationPrevToolTip property to provide custom text for the tooltip of the previous month navigation element in the title section of RadCalendar.
NavigationSummary String
Gets or sets a value for navigation controls summary.
Remarks
Setting this property to empty string will force Telerik RadCalendar to not render summary attribute
Orientation Orientation
Gets or sets the orientation (rendering direction) of the calendar component. Default value is RenderInRows.
Remarks
MemberDescriptionRenderInRowsRenders the calendar data row after row.RenderInColumnsRenderInColumns - Renders the calendar data column after column.NoneEnforces fallback to the default Orientation for Telerik RadCalendar.
OtherMonthDayStyle TableItemStyle
Gets the style properties for the days on the Calendar control that are not in the displayed month.
OutOfRangeDayStyle TableItemStyle
Gets the style properties for the days on the Calendar control that are out of the valid range for selection.
Overlay Boolean
Gets or sets a value indicating whether the calendar will create an overlay element to ensure popups are over a flash element or Java applet.
PresentationType PresentationType
Gets or sets the default type used by RadCalendar to handle its layout, and how will react to user interaction.
Remarks
MemberDescriptionInteractiveInteractive - user is allowed to select dates, navigate, etc.PreviewPreview - does not allow user interaction, for presentation purposes only.
RangeMaxDate DateTime
Gets or sets the maximum date valid for selection by Telerik RadCalendar. Must be interpreted as the Higher bound of the valid dates range available for selection. Telerik RadCalendar will not allow navigation or selection past this date.
Remarks
This property has a default value of 12/30/2099 (Gregorian calendar date).
RangeMinDate DateTime
Gets or sets the minimal date valid for selection by Telerik RadCalendar. Must be interpreted as the Lower bound of the valid dates range available for selection. Telerik RadCalendar will not allow navigation or selection prior to this date.
Remarks
This property has a default value of 1/1/1980 (Gregorian calendar date).
RangeSelectionEndDate DateTime
Gets or sets the end date when calendar range selection is enabled.
RangeSelectionMode RangeSelectionMode
Gets or sets the RadCalendar range selection mode. Default value is None.
Remarks
MemberDescriptionNoneDoes not allow range selection.OnKeyHoldAllow range selection by pressing [Shift] key and clicking on the date.NoneAllow range selection by clicking consecutively two dates.
RangeSelectionStartDate DateTime
Gets or sets the start date when calendar range selection is enabled.
RegisterWithScriptManager Boolean
Gets or sets the value, indicating whether to register with the ScriptManager control on the page.
Remarks
If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.
RenderMode RenderMode
Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css.
Remarks
Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.
ResolvedRenderMode RenderMode
Returns resolved RenderMode should the original value was Auto
RowHeaderImage String
Gets or sets the image displayed for the row header element.
Remarks
This property applies only if the ShowRowHeaders property is set to true. If RowHeaderText is set too, its value is set as an alternative text to the image of the row header.When using this property, the whole image URL is generated using also the ImagesBaseDir value.Example:ShowRowHeaders = "true"ImagesBaseDir = "Img/"RowHeaderImage = "selector.gif"complete image URL : "Img/selector.gif"
RowHeaderText String
Gets or sets the text displayed for the row header element.
Remarks
Use the RowHeaderText property to provide custom text for
the CalendarView complete row header element.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the RowHeaderText property. For
example, if you want to display an image for the next month navigation control, you
can set this property to an expression that contains an
element.This property applies only if the ShowRowsHeaders
property is set to true.
RuntimeSkin String
Gets the real skin name for the control user interface. If Skin is not set, returns "Default", otherwise returns Skin.
SelectedDate DateTime
Sets or returns the currently selected date. The default value is the value of System.DateTime.MinValue.
Remarks
Use the SelectedDate property to determine the selected date on the RadCalendar control.The SelectedDate property and the SelectedDates collection are closely related. When the EnableMultiSelect property is set to false, a mode that allows only a single date selection, SelectedDate and SelectedDates[0] have the same value and SelectedDates.Count equals 1. When the EnableMultiSelect property is set to true, mode that allows multiple date selections, SelectedDate and SelectedDates[0] have the same value.The SelectedDate property is set using a System.DateTime object.When the user selects a date on the RadCalendar control, the SelectionChanged event is raised. The SelectedDate property is updated to the selected date. The SelectedDates collection is also updated to contain just this date.Note Both the SelectedDate property and the SelectedDates collection are updated before the SelectionChanged event is raised. You can override the date selection by using the OnSelectionChanged event handler to manually set the SelectedDate property. The SelectionChanged event does not get raised when this property is programmatically set.
SelectedDates DateTime
Gets a collection of RadDate objects (that encapsulate values of type System.DateTime) that represent the selected dates on the RadCalendar control.
Remarks
Use the SelectedDates collection to determine the currently selected dates on the RadCalendar control.The SelectedDate property and the SelectedDates collection are closely related. When the EnableMultiSelect property is set to false, a mode that allows only a single date selection, SelectedDate and SelectedDates[0] have the same value and SelectedDates.Count equals 1. When the EnableMultiSelect property is set to true, mode that allows multiple date selections, SelectedDate and SelectedDates[0] have the same value.The SelectedDates property stores a collection of RadDate objects (that encapsulate values of type System.DateTime).When the user selects a date or date range (for example with the column or rows selectors) on the RadCalendar control, the SelectionChanged event is raised. The selected dates are added to the SelectedDates collection, accumulating with previously selected dates. The range of dates are not sorted by default. The SelectedDate property is also updated to contain the first date in the SelectedDates collection.You can also use the SelectedDates collection to programmatically select dates on the Calendar control. Use the
Add,
Remove,
Clear, and
SelectRange methods to programmatically manipulate the selected dates in the
SelectedDates collection.Note Both the SelectedDate property and the
SelectedDates collection are updated before the SelectionChanged
event is raised.You can override the dates selection by using the
OnSelectionChanged event handler to manually set the
SelectedDates collection. The SelectionChanged event is not
raised when this collection is programmatically set.
SelectedDayStyle TableItemStyle
Gets the style properties for the selected dates.
ShowColumnHeaders Boolean
Gets or sets whether the column headers will appear on the calendar.
ShowDayCellToolTips Boolean
Gets or sets a value indicating whether a tooltips for day cells should be rendered.
Remarks
Setting this property to false will force Telerik RadCalendar to not render day cell tooltips
ShowFastNavigationButtons Boolean
Gets or sets whether the fast navigation buttons in the title section will be displayed.
ShowNavigationButtons Boolean
Gets or sets whether the navigation buttons in the title section will be displayed.
ShowOtherMonthsDays Boolean
Gets or sets whether the month matrix, when rendered will show days from other (previous or next) months or will render only blank cells.
ShowRowHeaders Boolean
Gets or sets whether the row headers will appear on the calendar.
SingleViewColumns Int32
Gets or sets the the count of columns to be displayed by a single CalendarView.
Remarks
If the calendar represents a multi view, this property applies to the child views inside the multi view.
SingleViewHeight Unit
Gets or sets the Height applied to a single CalendarView.
Remarks
If the calendar represents a multi view, this property applies to the child views inside the multi view.
SingleViewRows Int32
Gets or sets the the count of rows to be displayed by a single CalendarView.
Remarks
If the calendar represents a multi view, this property applies to the child views inside the multi view.
SingleViewWidth Unit
Gets or sets the Width applied to a single CalendarView.
Remarks
If the calendar represents a multi view, this property applies to the child views inside the multi view.
Skin String
Gets or sets the name of the skin used. All skins reside in the location set by the SkinsPath Property.
Remarks
For additional information please refer to the Visual Settings topic in this manual.
Skin String
Gets or sets the skin name for the control user interface.
Remarks
If this property is not set, the control will render using the skin named "Default". If EnableEmbeddedSkins is set to false, the control will not render skin.
SpecialDays CalendarDayCollection
A collection of special days in the calendar to which may be applied specific formatting.
TitleAlign HorizontalAlign
Gets or sets the horizontal alignment of the calendar title.The HorizontalAlign enumeration is defined in System.Web.UI.WebControls
Remarks
Member nameDescriptionCenterThe contents of a container are centered.JustifyThe contents of a container are uniformly spread out and aligned with both the left and right margins.LeftThe contents of a container are left justified.NotSetThe horizontal alignment is not set.RightThe contents of a container are right justified.
TitleFormat String
Gets or sets the format string that is applied to the calendar title.
Remarks
The property should contain either a format specifier character or a custom format pattern. For more information, see the summary page for System.Globalization.DateTimeFormatInfo.By default this property uses formatting string of 'MMMM yyyy'. Valid formats are all supported by the .NET Framework.Example:"d" is the standard short date pattern."%d" returns the day of the month; "%d" is a custom pattern."d " returns the day of the month followed by a white-space character; "d " is a custom pattern.
TitleStyle TableItemStyle
Gets the style properties of the title heading for the Calendar control.
UseColumnHeadersAsSelectors Boolean
When the ShowColumnHeaders and/or ShowRowHeaders properties are set to true, the UseColumnHeadersAsSelectors property specifies whether to use the days of the week, which overrides the used text/image header if any.
UseRowHeadersAsSelectors Boolean
When the ShowColumnHeaders and/or ShowRowHeaders properties are set to true, the UseRowHeadersAsSelectors property specifies whether to use the number of the week, which overrides the used text/image selector if any.
ViewSelectorImage String
Gets or sets the image displayed for the complete CalendarView selection element in the view selector cell.
Remarks
When using this property, the whole image URL is generated using also the ImagesBaseDir value.Example:ImagesBaseDir = "Img/"ViewSelectorImage = "selector.gif"complete image URL : "Img/selector.gif"
ViewSelectorStyle TableItemStyle
Gets the style properties for the view selector cell.
ViewSelectorText String
Gets or sets the text displayed for the complete CalendarView selection element in the view selector cell.
Remarks
Use the ViewSelectorText property to provide custom text for
the CalendarView complete selection element in the selector
cell.This property does not automatically encode to HTML. You need
to convert special characters to the appropriate HTML value, unless
you want the characters to be treated as HTML. For example, to
explicitly display the greater than symbol (>), you must use the
value >.Because this property does not automatically encode to HTML, it is possible
to specify an HTML tag for the ViewSelectorText property. For
example, if you want to display an image for the next month navigation control, you
can set this property to an expression that contains an
element.This property applies only if the EnableViewSelector
property is set to true.
Visible Boolean
Gets or sets the visibility of the control.
WeekendDayStyle TableItemStyle
Gets the style properties for the weekend dates on the Calendar control.
Methods
ApplyConditionalRendering
Use this from RenderContents of the inheritor
Returns
System.Void
ControlPreRender
Code moved into this method from OnPreRender to make sure it executed when the framework skips OnPreRender() for some reason
Returns
System.Void
CreateChildControls
Create controls from template, fill ContentPanes and add them to Controls collection.
Returns
System.Void
FindControl
When using templates, their content is instantiated and "lives" inside the Controls collection of RadCalendar class. To access the controls instantiated from the templates they must be found using this method (RadCalendar implements INamingContainer interface).
Parameters
id System.String
The ID of the searched control.
Returns
System.Web.UI.Control Reference to the found control or null if no control was found.
FindControlRecursive
Recursively searches for a control with the specified id in the passed controls collection.
Parameters
controlID System.String
The id of the control to look for.
controlsCollection System.Web.UI.ControlCollection
The current Controls collection to search in.
Returns
System.Web.UI.Control The found control or null if nothing was found.
GetEmbeddedSkinNames
Returns the names of all embedded skins. Used by Telerik.Web.Examples.
Returns
System.Collections.Generic.List1`
LoadClientState
Loads the client state data
Parameters
clientState System.Collections.Generic.Dictionary{System.String,System.Object}
Returns
System.Void
LoadPostData
Executed when post data is loaded from the request
Parameters
postDataKey System.String
postCollection System.Collections.Specialized.NameValueCollection
Returns
System.Boolean
LoadViewState
Restores view-state information from a previous page request that was saved by the SaveViewState method.
Parameters
savedState System.Object
The saved view state.
Returns
System.Void
RaisePostDataChangedEvent
Executed when post data changes should invoke a changed event
Returns
System.Void
RegisterCssReferences
Registers the CSS references
Returns
System.Void
RegisterScriptControl
Registers the control with the ScriptManager
Returns
System.Void
ResetTemplates
This method supports the Telerik RadCalendar infrastructure and is not intended to be used directly from your code.
Returns
System.Void
SaveClientState
Saves the client state data
Returns
System.String
SaveViewState
Saves any server control view-state changes that have occurred since the time the page was posted back to the server.
Returns
System.Object The saved view state.