Skip to main content

CalendarControl Properties

Displays a monthly calendar and allows an end-user to select a date or date range(s).
Name Description
AccessibilityObject Gets the AccessibleObject assigned to the control. Inherited from Control.
AccessibleDefaultActionDescription Gets or sets the default action description of the control for use by accessibility client applications. Inherited from Control.
AccessibleDescription Gets or sets the description of the control used by accessibility client applications. Inherited from Control.
AccessibleName Gets or sets the name of the control used by accessibility client applications. Inherited from Control.
AccessibleRole Gets or sets the accessible role of the control. Inherited from Control.
AllowAnimatedContentChange Gets or sets whether animation effects are applied when switching between calendar views. Inherited from CalendarControlBase.
AllowClickInactiveDays Gets or sets whether a click on an inactive date (see CalendarControlBase.InactiveDaysVisibility) navigates to the corresponding (previous or next) month. Inherited from CalendarControlBase.
AllowDrop Gets or sets a value indicating whether the control can accept data that the user drags onto it. Inherited from Control.
AllowHtmlTextInToolTip Gets or sets whether HTML formatting is allowed in the control’s regular tooltips. Inherited from BaseControl.
Anchor Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. Inherited from Control.
Appearance Gets the appearance settings used to paint the control’s contents. Inherited from BaseStyleControl.
AppearanceCalendar Obsolete. This property is obsolete. Use the CalendarControlBase.CalendarAppearance property instead. Inherited from CalendarControlBase.
AppearanceDisabledCalendarDate Obsolete. This property is obsolete. Use the CalendarControlBase.CalendarAppearance property instead. Inherited from CalendarControlBase.
AppearanceHeader Obsolete. This property is obsolete. Use the CalendarControlBase.CalendarAppearance property instead. Inherited from CalendarControlBase.
AppearanceWeekNumber Obsolete. This property is obsolete. Use the CalendarControlBase.CalendarAppearance property instead. Inherited from CalendarControlBase.
AutoScrollOffset Gets or sets where this control is scrolled to in ScrollControlIntoView(Control). Inherited from Control.
AutoSize Gets or sets whether the calendar automatically adjusts its size depending on the calendar display mode. Inherited from CalendarControlBase.
AutoSizeInLayoutControl

When a control is added to a LayoutControl, this property specifies whether the control’s width is changed to display its content in its entirety. This member is supported by individual descendant of the BaseControl class.

Inherited from BaseControl.
BackColor This member is not supported by the class. Inherited from CalendarControlBase.
BackgroundImage This member is not supported by the class. Inherited from CalendarControlBase.
BackgroundImageLayout This member is not supported by the class. Inherited from CalendarControlBase.
BindingContext Gets or sets the BindingContext for the control. Inherited from Control.
BorderStyle Gets or sets the control’s border style. Inherited from BaseControl.
Bottom Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container’s client area. Inherited from Control.
Bounds Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. Inherited from Control.
ButtonsStyle Gets or sets the style of buttons within this control. Inherited from CalendarControlBase.
CalendarAppearance Contains appearance settings used to paint the Calendar’s elements and date cells in various states. When a Skin is active, only day cell-related appearance settings are in effect. Inherited from CalendarControlBase.
CalendarDateEditing Gets or sets whether an end-user can select a date in the calendar. Disable this setting to allow end-users to enter only the time portions of date-time values (see CalendarControlBase.CalendarTimeEditing). Inherited from CalendarControlBase.
CalendarHorizontalIndent Gets or sets the horizontal indent between adjacent months, in pixels. Inherited from CalendarControlBase.
CalendarIndent Gets or sets the vertical and horizontal indent between adjacent months, in pixels. Inherited from CalendarControlBase.
CalendarTimeEditing Gets or sets whether an end-user can edit the time portion of a date value via the calendar. This functionality is supported in the CalendarView.Vista and CalendarView.Classic display modes. Inherited from CalendarControlBase.
CalendarTimeProperties Contains settings related to time editing within the calendar. Inherited from CalendarControlBase.
CalendarVerticalIndent Gets or sets the vertical indent between adjacent months, in pixels. Inherited from CalendarControlBase.
CalendarView Gets or sets the calendar display mode. Inherited from CalendarControlBase.
CanClosePopup Returns whether or not this CalendarControlBase object’s popup can be closed at the moment. Inherited from CalendarControlBase.
CanEnableIme protected Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. Inherited from Control.
CanFocus Gets a value indicating whether the control can receive focus. Inherited from Control.
CanRaiseEvents protected Determines if events can be raised on the control. Inherited from Control.
CanSelect Gets a value indicating whether the control can be selected. Inherited from Control.
Capture Gets or sets a value indicating whether the control has captured the mouse. Inherited from Control.
CaseMonthNames Gets or sets the text case of month names. Inherited from CalendarControlBase.
CaseWeekDayAbbreviations Gets or sets the text case of days of the week abbreviations. Inherited from CalendarControlBase.
CausesValidation Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. Inherited from Control.
CellPadding Gets or sets the amount of space in pixels between a cell’s borders and its content (text). Inherited from CalendarControlBase.
CellSize Gets or sets calendar cell size. Inherited from CalendarControlBase.
CellStyleProvider Gets or sets the ICalendarCellStyleProvider object that allows you to customize the appearance of certain dates. Inherited from CalendarControlBase.
CheckForIllegalCrossThreadCalls static Gets or sets a value indicating whether to catch calls on the wrong thread that access a control’s Handle property when an application is being debugged. Inherited from Control.
ClientRectangle Gets the rectangle that represents the client area of the control. Inherited from Control.
ClientSize Gets or sets the height and width of the client area of the control. Inherited from Control.
ColumnCount Gets or sets the number of months displayed horizontally. Inherited from CalendarControlBase.
CompanyName Gets the name of the company or creator of the application containing the control. Inherited from Control.
Container Gets the IContainer that contains the Component. Inherited from Component.
ContainsFocus Gets a value indicating whether the control, or one of its child controls, currently has the input focus. Inherited from Control.
ContextButtonOptions Provides access to the settings applied to context buttons displayed in calendar cells. Inherited from CalendarControlBase.
ContextButtons Provides access to the collection of context buttons displayed in each calendar cell. Inherited from CalendarControlBase.
ContextMenu Gets or sets the shortcut menu associated with the control. Inherited from Control.
ContextMenuStrip Gets or sets the ContextMenuStrip associated with this control. Inherited from Control.
Controls Gets the collection of controls contained within the control. Inherited from Control.
Converter This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
Created Gets a value indicating whether the control has been created. Inherited from Control.
Cursor Gets or sets the cursor that is displayed when the mouse pointer is over the ControlBase control. Inherited from ControlBase.
DataBindings Gets the data bindings for the control. Inherited from Control.
DateFormat This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
DateTime Gets or sets the edit value (current date). This value is in sync with the CalendarControlBase.EditValue property. Inherited from CalendarControlBase.
DefaultBackColor static Gets the default background color of the control. Inherited from Control.
DefaultCursor protected Gets or sets the default cursor for the control. Inherited from Control.
DefaultFont static Gets the default font of the control. Inherited from Control.
DefaultForeColor static Gets the default foreground color of the control. Inherited from Control.
DefaultImeMode protected Gets the default Input Method Editor (IME) mode supported by the control. Inherited from Control.
DefaultMargin protected Gets the space, in pixels, that is specified by default between controls. Inherited from Control.
DefaultMaximumSize protected Gets the length and height, in pixels, that is specified as the default maximum size of a control. Inherited from Control.
DefaultMinimumSize protected Gets the length and height, in pixels, that is specified as the default minimum size of a control. Inherited from Control.
DesignMode protected Gets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DisabledDateProvider Allows you to assign an ICalendarDisabledDateProvider object that can disable certain dates to prevent them from being selected by an end-user. Inherited from CalendarControlBase.
DisplayRectangle Gets the rectangle that represents the display area of the control. Inherited from Control.
Disposing Gets a value indicating whether the base Control class is in the process of disposing. Inherited from Control.
Dock Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. Inherited from Control.
DoubleBuffered protected Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. Inherited from Control.
DrawCellLines Gets or sets whether to draw lines between calendar cells. Inherited from CalendarControlBase.
EditValue Gets or sets the edit value (current date). Inherited from CalendarControlBase.
Enabled Gets or sets a value indicating whether the control can respond to user interaction. Inherited from Control.
Events protected Gets the list of event handlers that are attached to this Component. Inherited from Component.
FirstDayOfWeek Gets or sets the first day of the week. Inherited from CalendarControlBase.
Focused Gets a value indicating whether the control has input focus. Inherited from Control.
Font This member is not supported by the class. Inherited from CalendarControlBase.
FontHeight protected Gets or sets the height of the font of the control. Inherited from Control.
ForeColor This member is not supported by the class. Inherited from CalendarControlBase.
FullButtonsHeight Obsolete. This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
Handle Gets the window handle that the control is bound to. Inherited from Control.
HasChildren Gets a value indicating whether the control contains one or more child controls. Inherited from Control.
HeaderPadding Gets or sets the amount of space around the calendar header displaying the current month and year. This property is in effect for the Classic calendar view. Inherited from CalendarControlBase.
Height Gets or sets the height of the control. Inherited from Control.
HighlightHolidays Gets or sets whether Saturdays and Sundays are highlighted. You can customize the appearance of these days using the CalendarControlBase.CalendarAppearance property. Inherited from CalendarControlBase.
HighlightSelection Gets or sets whether the selection is highlighted. Inherited from CalendarControlBase.
HighlightTodayCell Gets or sets whether Today’s date is highlighted. Inherited from CalendarControlBase.
HighlightTodayCellWhenSelected Gets or sets how the cell that displays today date should be painted upon selection. You may choose between the ‘Today cell’ and ‘selected cell’ highlight styles. Inherited from CalendarControlBase.
HotDate Gets the hot-tracked date. Inherited from CalendarControlBase.
ImeMode Gets or sets the Input Method Editor (IME) mode of the control. Inherited from Control.
ImeModeBase protected Gets or sets the IME mode of a control. Inherited from Control.
InactiveDaysVisibility Gets or sets the visibility of dates that do not belong to the current month. Inherited from CalendarControlBase.
InvokeRequired Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. Inherited from Control.
IsAccessible Gets or sets a value indicating whether the control is visible to accessibility applications. Inherited from Control.
IsDateCleared This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
IsDesignMode Gets a value indicating whether the control is currently in design mode. Inherited from BaseControl.
IsDisposed Gets a value indicating whether the control has been disposed of. Inherited from Control.
IsDrawing Get or sets whether the control is being drawn. For internal use. Inherited from CalendarControlBase.
IsHandleCreated Gets a value indicating whether the control has a handle associated with it. Inherited from Control.
IsLoading Gets whether the control is being initialized. Inherited from BaseControl.
IsMirrored Gets a value indicating whether the control is mirrored. Inherited from Control.
IsRightToLeft Gets whether the ControlBase‘s visual elements are actually aligned to support locales using right-to-left fonts. Inherited from ControlBase.
LayoutEngine Gets a cached instance of the control’s layout engine. Inherited from Control.
Left Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container’s client area. Inherited from Control.
Location Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. Inherited from Control.
LookAndFeel Provides access to the object containing the control’s look and feel settings. Inherited from BaseControl.
Margin Gets or sets the space between controls. Inherited from Control.
MaximumSize Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify. Inherited from Control.
MaxValue Gets or sets the maximum date displayed by the calendar. Inherited from CalendarControlBase.
MinimumSize Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify. Inherited from Control.
MinValue Gets or sets the minimum date displayed by the calendar. Inherited from CalendarControlBase.
ModifierKeys static Gets a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state. Inherited from Control.
MonthHeaderPadding Gets or sets the padding around month names when several months are displayed simultaneously. Inherited from CalendarControlBase.
MouseButtons static Gets a value indicating which of the mouse buttons is in a pressed state. Inherited from Control.
MousePosition static Gets the position of the mouse cursor in screen coordinates. Inherited from Control.
Multiselect Obsolete. This property is obsolete. Use the CalendarControlBase.SelectionMode property instead. Inherited from CalendarControlBase.
Name Gets or sets the name of the control. Inherited from Control.
NullDate Gets or sets the date assigned to the CalendarControlBase.DateTime property when the Clear button is clicked, or when the CalendarControlBase.EditValue property is set to null or any value that cannot be converted to the DateTime type. Inherited from CalendarControlBase.
Padding Gets or sets padding within the control. Inherited from Control.
Parent Gets or sets the parent container of the control. Inherited from Control.
PreferredSize Gets the size of a rectangular area into which the control can fit. Inherited from Control.
ProductName Gets the product name of the assembly containing the control. Inherited from Control.
ProductVersion Gets the version of the assembly containing the control. Inherited from Control.
PropagatingImeMode protected static Gets an object that represents a propagating IME mode. Inherited from Control.
ReadOnly Gets or sets whether the Calendar is read-only, and thus an end-user is not able to change the date selection (CalendarControlBase.SelectedRanges) and edit value (CalendarControlBase.EditValue/CalendarControlBase.DateTime). Inherited from CalendarControlBase.
RecreatingHandle Gets a value indicating whether the control is currently re-creating its handle. Inherited from Control.
Region Gets or sets the window region associated with the control. Inherited from Control.
RenderRightToLeft protected This property is now obsolete. Inherited from Control.
ResizeRedraw protected Gets or sets a value indicating whether the control redraws itself when resized. Inherited from Control.
Right Gets the distance, in pixels, between the right edge of the control and the left edge of its container’s client area. Inherited from Control.
RightToLeft Gets or sets a value indicating whether control’s elements are aligned to support locales using right-to-left fonts. Inherited from Control.
RightToLeftLayout Gets or sets whether the control’s visual elements are aligned to support locales using right-to-left fonts. Inherited from CalendarControlBase.
RowCount Gets or sets the number of months displayed vertically. Inherited from CalendarControlBase.
ScaleChildren protected Gets a value that determines the scaling of child controls. Inherited from Control.
ScaleFactor Returns scale multipliers that are currently applied to a control’s original width and height. Inherited from BaseControl.
SelectedRanges

Gets or sets the selected date ranges (DateRange objects). Each DateRange object identifies dates that are EQUAL OR GREATER THAN the DateRange.StartDate and LESS THAN the DateRange.EndDate. Thus the last date is excluded from the range.

Inherited from CalendarControlBase.
Selection Obsolete. This property is obsolete. Use the CalendarControlBase.SelectedRanges property instead. Inherited from CalendarControlBase.
SelectionBehavior Gets or sets whether calendar date ranges are selected strictly from day to day being clicked, or through the entire weeks containing those days. Inherited from CalendarControlBase.
SelectionEnd Gets the ending date of the selection. The SelectionEnd date is excluded from the selection. Inherited from CalendarControlBase.
SelectionMode Gets or sets whether a single date, or multiple dates can be simultaneously selected. Inherited from CalendarControlBase.
SelectionStart Gets the first date of the selection. Inherited from CalendarControlBase.
ShowCancelButton Gets whether the Cancel button is displayed. Inherited from CalendarControlBase.
ShowClearButton Gets or sets the visibility of the Clear button, which clears the current selection, sets the CalendarControlBase.EditValue property to null and the CalendarControlBase.DateTime property to the CalendarControlBase.NullDate value. Inherited from CalendarControlBase.
ShowFocusCues protected Gets a value indicating whether the control should display focus rectangles. Inherited from Control.
ShowFooter Gets or sets whether the calendar footer is displayed. Inherited from CalendarControlBase.
ShowHeader Gets or sets whether the calendar header is displayed. Inherited from CalendarControlBase.
ShowKeyboardCues protected Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. Inherited from Control.
ShowMonthHeaders Gets or sets the visibility of month names for each month. Inherited from CalendarControlBase.
ShowMonthNavigationButtons Gets or sets the visibility of buttons that let you navigate between months. Inherited from CalendarControlBase.
ShowOkButton Gets whether the OK button is displayed. Inherited from CalendarControlBase.
ShowTodayButton Gets or sets the visibility of the Today button. Inherited from CalendarControlBase.
ShowToolTips Gets or sets whether a tooltip should be displayed when the mouse pointer is over the control. Inherited from BaseControl.
ShowWeekNumbers Gets or sets whether to display week numbers in the calendar. Inherited from CalendarControlBase.
ShowYearNavigationButtons Gets or sets the visibility of buttons that let you navigate between years. Inherited from CalendarControlBase.
Site Gets or sets the site of the control. Inherited from Control.
Size Gets or sets the height and width of the control. Inherited from Control.
SpecialDateProvider Allows you to assign an ICalendarSpecialDateProvider object that can mark certain dates as “special” to highlight them in a custom manner, as specified by the dedicated appearance settings of the CalendarControlBase.CalendarAppearance object. Inherited from CalendarControlBase.
StartDate This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
StyleController Gets or sets the style controller component that provides style settings for this control. Inherited from BaseControl.
SuperTip Gets or sets a SuperToolTip for the current control. Inherited from BaseControl.
SyncSelectionWithEditValue Gets or sets whether changing the CalendarControlBase.DateTime/CalendarControlBase.EditValue property updates the current selection. Inherited from CalendarControlBase.
TabIndex Gets or sets the tab order of the control within its container. Inherited from Control.
TabStop Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. Inherited from Control.
Tag Gets or sets the object that contains data about the control. Inherited from Control.
Text This member supports the internal infrastructure, and is not intended to be used directly from your code. This property is not relevant for this class. Inherited from CalendarControlBase.
TimeEdit This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
TimeEditWidth Gets or sets the width, in pixels, of the edit box that allows end-users to edit the time portion of the edit value. Inherited from CalendarControlBase.
TodayDate Gets or sets the date that is regarded as Today’s date. Inherited from CalendarControlBase.
TodayDayCellFrameColor Obsolete. Gets or sets the border color of the Today cell. Inherited from CalendarControlBase.
ToolTip Gets or sets a regular tooltip’s text content. Inherited from BaseControl.
ToolTipAnchor This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from BaseControl.
ToolTipController Gets or sets the tooltip controller component that controls the appearance, position and content of hints displayed for this control. Inherited from BaseControl.
ToolTipIconType Gets or sets the type of the tooltip icon. Inherited from BaseControl.
ToolTipTitle Gets or sets a regular tooltip’s title. Inherited from BaseControl.
Top Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container’s client area. Inherited from Control.
TopLevelControl Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. Inherited from Control.
UpdateDateTimeWhenNavigating Gets or sets whether the same day (as in the current month) is selected in another month when you navigate from the current month to that month. Inherited from CalendarControlBase.
UpdateSelectionWhenNavigating Gets or sets whether the same range of days (as in the current month) is automatically selected in another month when you navigate from the current month to that month. The CalendarControlBase.SyncSelectionWithEditValue property must be set to false to support this feature. Inherited from CalendarControlBase.
UseDirectXPaint Gets or sets whether the DirectX Hardware Acceleration is enabled for the Calendar Control. Inherited from CalendarControlBase.
UseWaitCursor Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. Inherited from Control.
View Gets or sets the current date grouping View. This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from CalendarControlBase.
Visible Gets or sets a value indicating whether the control and all its child controls are displayed. Inherited from Control.
VistaCalendarViewStyle Gets or sets which date grouping Views are available in Vista display mode. Inherited from CalendarControlBase.
WeekDayAbbreviationLength Gets or sets the length of days of the week abbreviations. Inherited from CalendarControlBase.
WeekNumberRule Gets or sets a rule which determines the first week of the year. Inherited from CalendarControlBase.
Width Gets or sets the width of the control. Inherited from Control.
WindowTarget This property is not relevant for this class. Inherited from Control.
See Also