0 out of 2 rated this helpful - Rate this topic

MonthCalendar Class

Represents a Windows control that enables the user to select a date using a visual monthly calendar display.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.MonthCalendar

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
[DefaultBindingPropertyAttribute("SelectionRange")]
public class MonthCalendar : Control

The MonthCalendar type exposes the following members.

  Name Description
Public method MonthCalendar Initializes a new instance of the MonthCalendar class.
Top
  Name Description
Public property AccessibilityObject Gets the AccessibleObject assigned to the control. (Inherited from Control.)
Public property AccessibleDefaultActionDescription Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.)
Public property AccessibleDescription Gets or sets the description of the control used by accessibility client applications. (Inherited from Control.)
Public property AccessibleName Gets or sets the name of the control used by accessibility client applications. (Inherited from Control.)
Public property AccessibleRole Gets or sets the accessible role of the control (Inherited from Control.)
Public property AllowDrop Gets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control.)
Public property 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.)
Public property AnnuallyBoldedDates Gets or sets the array of DateTime objects that determines which annual days are displayed in bold.
Public property AutoScrollOffset Gets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.)
Public property AutoSize Infrastructure. This property is not relevant for this class. (Inherited from Control.)
Public property BackColor Gets or sets the background color for the control. (Overrides Control.BackColor.)
Public property BackgroundImage Infrastructure. Gets or sets the background image for the MonthCalendar (Overrides Control.BackgroundImage.)
Public property BackgroundImageLayout Infrastructure. Gets or sets a value indicating the layout for the BackgroundImage. (Overrides Control.BackgroundImageLayout.)
Public property BindingContext Gets or sets the BindingContext for the control. (Inherited from Control.)
Public property BoldedDates Gets or sets the array of DateTime objects that determines which nonrecurring dates are displayed in bold.
Public property 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.)
Public property 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.)
Public property CalendarDimensions Gets or sets the number of columns and rows of months displayed.
Protected property CanEnableIme Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. (Inherited from Control.)
Public property CanFocus Gets a value indicating whether the control can receive focus. (Inherited from Control.)
Protected property CanRaiseEvents Determines if events can be raised on the control. (Inherited from Control.)
Public property CanSelect Gets a value indicating whether the control can be selected. (Inherited from Control.)
Public property Capture Gets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.)
Public property 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.)
Public property ClientRectangle Gets the rectangle that represents the client area of the control. (Inherited from Control.)
Public property ClientSize Gets or sets the height and width of the client area of the control. (Inherited from Control.)
Public property CompanyName Gets the name of the company or creator of the application containing the control. (Inherited from Control.)
Public property Container Gets the IContainer that contains the Component. (Inherited from Component.)
Public property ContainsFocus Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
Public property ContextMenu Gets or sets the shortcut menu associated with the control. (Inherited from Control.)
Public property ContextMenuStrip Gets or sets the ContextMenuStrip associated with this control. (Inherited from Control.)
Public property Controls Gets the collection of controls contained within the control. (Inherited from Control.)
Public property Created Gets a value indicating whether the control has been created. (Inherited from Control.)
Protected property CreateParams Gets a System.Windows.Forms.CreateParams for creating a MonthCalendar control. (Overrides Control.CreateParams.)
Public property Cursor Gets or sets the cursor that is displayed when the mouse pointer is over the control. (Inherited from Control.)
Public property DataBindings Gets the data bindings for the control. (Inherited from Control.)
Protected property DefaultCursor Gets or sets the default cursor for the control. (Inherited from Control.)
Protected property DefaultImeMode Gets a value indicating the input method editor for the MonthCalendar. (Overrides Control.DefaultImeMode.)
Protected property DefaultMargin Gets the default margin settings for the MonthCalendar control. (Overrides Control.DefaultMargin.)
Protected property DefaultMaximumSize Gets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control.)
Protected property DefaultMinimumSize Gets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control.)
Protected property DefaultPadding Gets the internal spacing, in pixels, of the contents of a control. (Inherited from Control.)
Protected property DefaultSize Gets the default size of the calendar. (Overrides Control.DefaultSize.)
Protected property DesignMode Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public property DisplayRectangle Gets the rectangle that represents the display area of the control. (Inherited from Control.)
Public property Disposing Gets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.)
Public property 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.)
Protected property DoubleBuffered Gets or sets a value indicating whether the control should redraw its surface using a secondary buffer. (Overrides Control.DoubleBuffered.)
Public property Enabled Gets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control.)
Protected property Events Gets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public property FirstDayOfWeek Gets or sets the first day of the week as displayed in the month calendar.
Public property Focused Gets a value indicating whether the control has input focus. (Inherited from Control.)
Public property Font Gets or sets the font of the text displayed by the control. (Inherited from Control.)
Protected property FontHeight Gets or sets the height of the font of the control. (Inherited from Control.)
Public property ForeColor Gets or sets the foreground color of the control. (Overrides Control.ForeColor.)
Public property Handle Gets the window handle that the control is bound to. (Inherited from Control.)
Public property HasChildren Gets a value indicating whether the control contains one or more child controls. (Inherited from Control.)
Public property Height Gets or sets the height of the control. (Inherited from Control.)
Public property ImeMode Infrastructure. Gets or sets the Input Method Editor (IME) mode supported by this control.
Protected property ImeModeBase Gets or sets the IME mode of a control. (Inherited from Control.)
Public property 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.)
Public property IsAccessible Gets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.)
Public property IsDisposed Gets a value indicating whether the control has been disposed of. (Inherited from Control.)
Public property IsHandleCreated Gets a value indicating whether the control has a handle associated with it. (Inherited from Control.)
Public property IsMirrored Gets a value indicating whether the control is mirrored. (Inherited from Control.)
Public property LayoutEngine Gets a cached instance of the control's layout engine. (Inherited from Control.)
Public property 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.)
Public property 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.)
Public property Margin Gets or sets the space between controls. (Inherited from Control.)
Public property MaxDate Gets or sets the maximum allowable date.
Public property MaximumSize Gets or sets the size that is the upper limit that GetPreferredSize can specify. (Inherited from Control.)
Public property MaxSelectionCount Gets or sets the maximum number of days that can be selected in a month calendar control.
Public property MinDate Gets or sets the minimum allowable date.
Public property MinimumSize Gets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.)
Public property MonthlyBoldedDates Gets or sets the array of DateTime objects that determine which monthly days to bold.
Public property Name Gets or sets the name of the control. (Inherited from Control.)
Public property Padding Infrastructure. Gets or sets the space between the edges of a MonthCalendar control and its contents.
Public property Parent Gets or sets the parent container of the control. (Inherited from Control.)
Public property PreferredSize Gets the size of a rectangular area into which the control can fit. (Inherited from Control.)
Public property ProductName Gets the product name of the assembly containing the control. (Inherited from Control.)
Public property ProductVersion Gets the version of the assembly containing the control. (Inherited from Control.)
Public property RecreatingHandle Gets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.)
Public property Region Gets or sets the window region associated with the control. (Inherited from Control.)
Protected property RenderRightToLeft Obsolete. This property is now obsolete. (Inherited from Control.)
Protected property ResizeRedraw Gets or sets a value indicating whether the control redraws itself when resized. (Inherited from Control.)
Public property 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.)
Public property RightToLeft Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from Control.)
Public property RightToLeftLayout Gets or sets a value indicating whether the control is laid out from right to left.
Protected property ScaleChildren Gets a value that determines the scaling of child controls. (Inherited from Control.)
Public property ScrollChange Gets or sets the scroll rate for a month calendar control.
Public property SelectionEnd Gets or sets the end date of the selected range of dates.
Public property SelectionRange Gets or sets the selected range of dates for a month calendar control.
Public property SelectionStart Gets or sets the start date of the selected range of dates.
Protected property ShowFocusCues Gets a value indicating whether the control should display focus rectangles. (Inherited from Control.)
Protected property ShowKeyboardCues Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control.)
Public property ShowToday Gets or sets a value indicating whether the date represented by the TodayDate property is displayed at the bottom of the control.
Public property ShowTodayCircle Gets or sets a value indicating whether today's date is identified with a circle or a square.
Public property ShowWeekNumbers Gets or sets a value indicating whether the month calendar control displays week numbers (1-52) to the left of each row of days.
Public property SingleMonthSize Gets the minimum size to display one month of the calendar.
Public property Site Gets or sets the site of the control. (Inherited from Control.)
Public property Size Gets or sets the size of the MonthCalendar control.
Public property TabIndex Gets or sets the tab order of the control within its container. (Inherited from Control.)
Public property TabStop Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.)
Public property Tag Gets or sets the object that contains data about the control. (Inherited from Control.)
Public property Text Infrastructure. Gets or sets the text to display on the MonthCalendar. (Overrides Control.Text.)
Public property TitleBackColor Gets or sets a value indicating the background color of the title area of the calendar.
Public property TitleForeColor Gets or sets a value indicating the foreground color of the title area of the calendar.
Public property TodayDate Gets or sets the value that is used by MonthCalendar as today's date.
Public property TodayDateSet Gets a value indicating whether the TodayDate property has been explicitly set.
Public property 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.)
Public property 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.)
Public property TrailingForeColor Gets or sets a value indicating the color of days in months that are not fully displayed in the control.
Public property UseWaitCursor Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control.)
Public property Visible Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
Public property Width Gets or sets the width of the control. (Inherited from Control.)
Public property WindowTarget Infrastructure. This property is not relevant for this class. (Inherited from Control.)
Top
  Name Description
Protected method AccessibilityNotifyClients(AccessibleEvents, Int32) Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.)
Protected method AccessibilityNotifyClients(AccessibleEvents, Int32, Int32) Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control.)
Public method AddAnnuallyBoldedDate Adds a day that is displayed in bold on an annual basis in the month calendar.
Public method AddBoldedDate Adds a day to be displayed in bold in the month calendar.
Public method AddMonthlyBoldedDate Adds a day that is displayed in bold on a monthly basis in the month calendar.
Public method BeginInvoke(Delegate) Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public method BeginInvoke(Delegate, Object[]) Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public method BringToFront Brings the control to the front of the z-order. (Inherited from Control.)
Public method Contains Retrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.)
Protected method CreateAccessibilityInstance Creates a new accessibility object for the control. (Inherited from Control.)
Public method CreateControl Forces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.)
Protected method CreateControlsInstance Creates a new instance of the control collection for the control. (Inherited from Control.)
Public method CreateGraphics Creates the Graphics for the control. (Inherited from Control.)
Protected method CreateHandle Infrastructure. Overrides the CreateHandle method. (Overrides Control.CreateHandle().)
Public method CreateObjRef Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Protected method DefWndProc Sends the specified message to the default window procedure. (Inherited from Control.)
Protected method DestroyHandle Destroys the handle associated with the control. (Inherited from Control.)
Public method Dispose() Releases all resources used by the Component. (Inherited from Component.)
Protected method Dispose(Boolean) Releases all resources used by the MonthCalendar. (Overrides Control.Dispose(Boolean).)
Public method DoDragDrop Begins a drag-and-drop operation. (Inherited from Control.)
Public method DrawToBitmap Supports rendering to the specified bitmap. (Inherited from Control.)
Public method EndInvoke Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public method FindForm Retrieves the form that the control is on. (Inherited from Control.)
Public method Focus Sets input focus to the control. (Inherited from Control.)
Protected method GetAccessibilityObjectById Retrieves the specified AccessibleObject. (Inherited from Control.)
Protected method GetAutoSizeMode Retrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public method GetChildAtPoint(Point) Retrieves the child control that is located at the specified coordinates. (Inherited from Control.)
Public method GetChildAtPoint(Point, GetChildAtPointSkip) Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control.)
Public method GetContainerControl Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
Public method GetDisplayRange Retrieves date information that represents the low and high limits of the displayed dates of the control.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetLifetimeService Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public method GetNextControl Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
Public method GetPreferredSize Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
Protected method GetScaledBounds Retrieves the bounds within which the control is scaled. (Inherited from Control.)
Protected method GetService Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Protected method GetStyle Retrieves the value of the specified control style bit for the control. (Inherited from Control.)
Protected method GetTopLevel Determines if the control is a top-level control. (Inherited from Control.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method Hide Conceals the control from the user. (Inherited from Control.)
Public method HitTest(Point) Returns an object with information on which portion of a month calendar control is at a location specified by a Point.
Public method HitTest(Int32, Int32) Returns a MonthCalendar.HitTestInfo with information on which portion of a month calendar control is at a specified x- and y-coordinate.
Public method InitializeLifetimeService Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected method InitLayout Called after the control has been added to another container. (Inherited from Control.)
Public method Invalidate() Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control.)
Public method Invalidate(Boolean) Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public method Invalidate(Rectangle) Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public method Invalidate(Region) Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public method Invalidate(Rectangle, Boolean) Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public method Invalidate(Region, Boolean) Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public method Invoke(Delegate) Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
Public method Invoke(Delegate, Object[]) Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control.)
Protected method InvokeGotFocus Raises the GotFocus event for the specified control. (Inherited from Control.)
Protected method InvokeLostFocus Raises the LostFocus event for the specified control. (Inherited from Control.)
Protected method InvokeOnClick Raises the Click event for the specified control. (Inherited from Control.)
Protected method InvokePaint Raises the Paint event for the specified control. (Inherited from Control.)
Protected method InvokePaintBackground Raises the PaintBackground event for the specified control. (Inherited from Control.)
Protected method IsInputChar Determines if a character is an input character that the control recognizes. (Inherited from Control.)
Protected method IsInputKey Determines whether the specified key is a regular input key or a special key that requires preprocessing. (Overrides Control.IsInputKey(Keys).)
Protected method MemberwiseClone() Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method MemberwiseClone(Boolean) Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Protected method NotifyInvalidate Infrastructure. Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control.)
Protected method OnAutoSizeChanged Raises the AutoSizeChanged event. (Inherited from Control.)
Protected method OnBackColorChanged Raises the BackColorChanged event. (Overrides Control.OnBackColorChanged(EventArgs).)
Protected method OnBackgroundImageChanged Raises the BackgroundImageChanged event. (Inherited from Control.)
Protected method OnBackgroundImageLayoutChanged Raises the BackgroundImageLayoutChanged event. (Inherited from Control.)
Protected method OnBindingContextChanged Raises the BindingContextChanged event. (Inherited from Control.)
Protected method OnCausesValidationChanged Raises the CausesValidationChanged event. (Inherited from Control.)
Protected method OnChangeUICues Raises the ChangeUICues event. (Inherited from Control.)
Protected method OnClick Raises the Click event. (Inherited from Control.)
Protected method OnClientSizeChanged Raises the ClientSizeChanged event. (Inherited from Control.)
Protected method OnContextMenuChanged Raises the ContextMenuChanged event. (Inherited from Control.)
Protected method OnContextMenuStripChanged Raises the ContextMenuStripChanged event. (Inherited from Control.)
Protected method OnControlAdded Raises the ControlAdded event. (Inherited from Control.)
Protected method OnControlRemoved Raises the ControlRemoved event. (Inherited from Control.)
Protected method OnCreateControl Raises the CreateControl method. (Inherited from Control.)
Protected method OnCursorChanged Raises the CursorChanged event. (Inherited from Control.)
Protected method OnDateChanged Raises the DateChanged event.
Protected method OnDateSelected Raises the DateSelected event.
Protected method OnDockChanged Raises the DockChanged event. (Inherited from Control.)
Protected method OnDoubleClick Raises the DoubleClick event. (Inherited from Control.)
Protected method OnDragDrop Raises the DragDrop event. (Inherited from Control.)
Protected method OnDragEnter Raises the DragEnter event. (Inherited from Control.)
Protected method OnDragLeave Raises the DragLeave event. (Inherited from Control.)
Protected method OnDragOver Raises the DragOver event. (Inherited from Control.)
Protected method OnEnabledChanged Raises the EnabledChanged event. (Inherited from Control.)
Protected method OnEnter Raises the Enter event. (Inherited from Control.)
Protected method OnFontChanged Raises the FontChanged event. (Overrides Control.OnFontChanged(EventArgs).)
Protected method OnForeColorChanged Raises the ForeColorChanged event. (Overrides Control.OnForeColorChanged(EventArgs).)
Protected method OnGiveFeedback Raises the GiveFeedback event. (Inherited from Control.)
Protected method OnGotFocus Raises the GotFocus event. (Inherited from Control.)
Protected method OnHandleCreated Infrastructure. Overrides the OnHandleCreated method. (Overrides Control.OnHandleCreated(EventArgs).)
Protected method OnHandleDestroyed Raises the HandleDestroyed event. (Overrides Control.OnHandleDestroyed(EventArgs).)
Protected method OnHelpRequested Raises the HelpRequested event. (Inherited from Control.)
Protected method OnImeModeChanged Raises the ImeModeChanged event. (Inherited from Control.)
Protected method OnInvalidated Raises the Invalidated event. (Inherited from Control.)
Protected method OnKeyDown Raises the KeyDown event. (Inherited from Control.)
Protected method OnKeyPress Raises the KeyPress event. (Inherited from Control.)
Protected method OnKeyUp Raises the KeyUp event. (Inherited from Control.)
Protected method OnLayout Raises the Layout event. (Inherited from Control.)
Protected method OnLeave Raises the Leave event. (Inherited from Control.)
Protected method OnLocationChanged Raises the LocationChanged event. (Inherited from Control.)
Protected method OnLostFocus Raises the LostFocus event. (Inherited from Control.)
Protected method OnMarginChanged Raises the MarginChanged event. (Inherited from Control.)
Protected method OnMouseCaptureChanged Raises the MouseCaptureChanged event. (Inherited from Control.)
Protected method OnMouseClick Raises the MouseClick event. (Inherited from Control.)
Protected method OnMouseDoubleClick Raises the MouseDoubleClick event. (Inherited from Control.)
Protected method OnMouseDown Raises the MouseDown event. (Inherited from Control.)
Protected method OnMouseEnter Raises the MouseEnter event. (Inherited from Control.)
Protected method OnMouseHover Raises the MouseHover event. (Inherited from Control.)
Protected method OnMouseLeave Raises the MouseLeave event. (Inherited from Control.)
Protected method OnMouseMove Raises the MouseMove event. (Inherited from Control.)
Protected method OnMouseUp Raises the MouseUp event. (Inherited from Control.)
Protected method OnMouseWheel Raises the MouseWheel event. (Inherited from Control.)
Protected method OnMove Raises the Move event. (Inherited from Control.)
Protected method OnNotifyMessage Notifies the control of Windows messages. (Inherited from Control.)
Protected method OnPaddingChanged Raises the PaddingChanged event. (Inherited from Control.)
Protected method OnPaint Raises the Paint event. (Inherited from Control.)
Protected method OnPaintBackground Paints the background of the control. (Inherited from Control.)
Protected method OnParentBackColorChanged Raises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control.)
Protected method OnParentBackgroundImageChanged Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control.)
Protected method OnParentBindingContextChanged Raises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control.)
Protected method OnParentChanged Raises the ParentChanged event. (Inherited from Control.)
Protected method OnParentCursorChanged Raises the CursorChanged event. (Inherited from Control.)
Protected method OnParentEnabledChanged Raises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control.)
Protected method OnParentFontChanged Raises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control.)
Protected method OnParentForeColorChanged Raises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control.)
Protected method OnParentRightToLeftChanged Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control.)
Protected method OnParentVisibleChanged Raises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control.)
Protected method OnPreviewKeyDown Raises the PreviewKeyDown event. (Inherited from Control.)
Protected method OnPrint Raises the Paint event. (Inherited from Control.)
Protected method OnQueryContinueDrag Raises the QueryContinueDrag event. (Inherited from Control.)
Protected method OnRegionChanged Raises the RegionChanged event. (Inherited from Control.)
Protected method OnResize Raises the Resize event. (Inherited from Control.)
Protected method OnRightToLeftChanged Raises the RightToLeftChanged event. (Inherited from Control.)
Protected method OnRightToLeftLayoutChanged Raises the RightToLeftLayoutChanged event.
Protected method OnSizeChanged Raises the SizeChanged event. (Inherited from Control.)
Protected method OnStyleChanged Raises the StyleChanged event. (Inherited from Control.)
Protected method OnSystemColorsChanged Raises the SystemColorsChanged event. (Inherited from Control.)
Protected method OnTabIndexChanged Raises the TabIndexChanged event. (Inherited from Control.)
Protected method OnTabStopChanged Raises the TabStopChanged event. (Inherited from Control.)
Protected method OnTextChanged Raises the TextChanged event. (Inherited from Control.)
Protected method OnValidated Raises the Validated event. (Inherited from Control.)
Protected method OnValidating Raises the Validating event. (Inherited from Control.)
Protected method OnVisibleChanged Raises the VisibleChanged event. (Inherited from Control.)
Public method PerformLayout() Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public method PerformLayout(Control, String) Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public method PointToClient Computes the location of the specified screen point into client coordinates. (Inherited from Control.)
Public method PointToScreen Computes the location of the specified client point into screen coordinates. (Inherited from Control.)
Public method PreProcessControlMessage Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Public method PreProcessMessage Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Protected method ProcessCmdKey Processes a command key. (Inherited from Control.)
Protected method ProcessDialogChar Processes a dialog character. (Inherited from Control.)
Protected method ProcessDialogKey Processes a dialog key. (Inherited from Control.)
Protected method ProcessKeyEventArgs Processes a key message and generates the appropriate control events. (Inherited from Control.)
Protected method ProcessKeyMessage Processes a keyboard message. (Inherited from Control.)
Protected method ProcessKeyPreview Previews a keyboard message. (Inherited from Control.)
Protected method ProcessMnemonic Processes a mnemonic character. (Inherited from Control.)
Protected method RaiseDragEvent Infrastructure. Raises the appropriate drag event. (Inherited from Control.)
Protected method RaiseKeyEvent Infrastructure. Raises the appropriate key event. (Inherited from Control.)
Protected method RaiseMouseEvent Infrastructure. Raises the appropriate mouse event. (Inherited from Control.)
Protected method RaisePaintEvent Infrastructure. Raises the appropriate paint event. (Inherited from Control.)
Protected method RecreateHandle Forces the re-creation of the handle for the control. (Inherited from Control.)
Public method RectangleToClient Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
Public method RectangleToScreen Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.)
Public method Refresh Forces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Control.)
Public method RemoveAllAnnuallyBoldedDates Removes all the annually bold dates.
Public method RemoveAllBoldedDates Removes all the nonrecurring bold dates.
Public method RemoveAllMonthlyBoldedDates Removes all the monthly bold dates.
Public method RemoveAnnuallyBoldedDate Removes the specified date from the list of annually bold dates.
Public method RemoveBoldedDate Removes the specified date from the list of nonrecurring bold dates.
Public method RemoveMonthlyBoldedDate Removes the specified date from the list of monthly bolded dates.
Public method ResetBackColor Resets the BackColor property to its default value. (Inherited from Control.)
Public method ResetBindings Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.)
Public method ResetCursor Resets the Cursor property to its default value. (Inherited from Control.)
Public method ResetFont Resets the Font property to its default value. (Inherited from Control.)
Public method ResetForeColor Resets the ForeColor property to its default value. (Inherited from Control.)
Public method ResetImeMode Resets the ImeMode property to its default value. (Inherited from Control.)
Protected method ResetMouseEventArgs Infrastructure. Resets the control to handle the MouseLeave event. (Inherited from Control.)
Public method ResetRightToLeft Resets the RightToLeft property to its default value. (Inherited from Control.)
Public method ResetText Resets the Text property to its default value. (Inherited from Control.)
Public method ResumeLayout() Resumes usual layout logic. (Inherited from Control.)
Public method ResumeLayout(Boolean) Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.)
Protected method RtlTranslateAlignment(ContentAlignment) Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateAlignment(HorizontalAlignment) Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateAlignment(LeftRightAlignment) Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateContent Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateHorizontal Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateLeftRight Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Public method Scale(Single) Obsolete. Scales the control and any child controls. (Inherited from Control.)
Public method Scale(SizeF) Scales the control and all child controls by the specified scaling factor. (Inherited from Control.)
Public method Scale(Single, Single) Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
Protected method ScaleControl Scales a control's location, size, padding and margin. (Inherited from Control.)
Protected method ScaleCore Infrastructure. This method is not relevant for this class. (Inherited from Control.)
Public method Select() Activates the control. (Inherited from Control.)
Protected method Select(Boolean, Boolean) Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from Control.)
Public method SelectNextControl Activates the next control. (Inherited from Control.)
Public method SendToBack Sends the control to the back of the z-order. (Inherited from Control.)
Protected method SetAutoSizeMode Sets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public method SetBounds(Int32, Int32, Int32, Int32) Sets the bounds of the control to the specified location and size. (Inherited from Control.)
Public method SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified) Sets the specified bounds of the control to the specified location and size. (Inherited from Control.)
Protected method SetBoundsCore Overrides the SetBoundsCore method. (Overrides Control.SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified).)
Public method SetCalendarDimensions Sets the number of columns and rows of months to display.
Protected method SetClientSizeCore Sets the size of the client area of the control. (Inherited from Control.)
Public method SetDate Sets a date as the currently selected date.
Public method SetSelectionRange Sets the selected dates in a month calendar control to the specified date range.
Protected method SetStyle Sets a specified ControlStyles flag to either true or false. (Inherited from Control.)
Protected method SetTopLevel Sets the control as the top-level control. (Inherited from Control.)
Protected method SetVisibleCore Sets the control to the specified visible state. (Inherited from Control.)
Public method Show Displays the control to the user. (Inherited from Control.)
Protected method SizeFromClientSize Determines the size of the entire control from the height and width of its client area. (Inherited from Control.)
Public method SuspendLayout Temporarily suspends the layout logic for the control. (Inherited from Control.)
Public method ToString Infrastructure. Returns a string that represents the MonthCalendar control. (Overrides Component.ToString().)
Public method Update Causes the control to redraw the invalidated regions within its client area. (Inherited from Control.)
Public method UpdateBoldedDates Repaints the bold dates to reflect the dates set in the lists of bold dates.
Protected method UpdateBounds() Updates the bounds of the control with the current size and location. (Inherited from Control.)
Protected method UpdateBounds(Int32, Int32, Int32, Int32) Updates the bounds of the control with the specified size and location. (Inherited from Control.)
Protected method UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32) Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control.)
Protected method UpdateStyles Forces the assigned styles to be reapplied to the control. (Inherited from Control.)
Protected method UpdateZOrder Updates the control in its parent's z-order. (Inherited from Control.)
Protected method WndProc Infrastructure. Overrides the WndProc method. (Overrides Control.WndProc(Message).)
Top
  Name Description
Public event AutoSizeChanged Infrastructure. This event is not relevant for this class. (Inherited from Control.)
Public event BackColorChanged Occurs when the value of the BackColor property changes. (Inherited from Control.)
Public event BackgroundImageChanged Infrastructure. Occurs when the value of the BackgroundImage property changes.
Public event BackgroundImageLayoutChanged Infrastructure. Occurs when the BackgroundImageLayout property changes.
Public event BindingContextChanged Occurs when the value of the BindingContext property changes. (Inherited from Control.)
Public event CausesValidationChanged Occurs when the value of the CausesValidation property changes. (Inherited from Control.)
Public event ChangeUICues Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control.)
Public event Click Infrastructure. Occurs when the user clicks the MonthCalendar control.
Public event ClientSizeChanged Occurs when the value of the ClientSize property changes. (Inherited from Control.)
Public event ContextMenuChanged Occurs when the value of the ContextMenu property changes. (Inherited from Control.)
Public event ContextMenuStripChanged Occurs when the value of the ContextMenuStrip property changes. (Inherited from Control.)
Public event ControlAdded Occurs when a new control is added to the Control.ControlCollection. (Inherited from Control.)
Public event ControlRemoved Occurs when a control is removed from the Control.ControlCollection. (Inherited from Control.)
Public event CursorChanged Occurs when the value of the Cursor property changes. (Inherited from Control.)
Public event DateChanged Occurs when the date selected in the MonthCalendar changes.
Public event DateSelected Occurs when the user makes an explicit date selection using the mouse.
Public event Disposed Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public event DockChanged Occurs when the value of the Dock property changes. (Inherited from Control.)
Public event DoubleClick Infrastructure. Occurs when the user double-clicks the MonthCalendar control.
Public event DragDrop Occurs when a drag-and-drop operation is completed. (Inherited from Control.)
Public event DragEnter Occurs when an object is dragged into the control's bounds. (Inherited from Control.)
Public event DragLeave Occurs when an object is dragged out of the control's bounds. (Inherited from Control.)
Public event DragOver Occurs when an object is dragged over the control's bounds. (Inherited from Control.)
Public event EnabledChanged Occurs when the Enabled property value has changed. (Inherited from Control.)
Public event Enter Occurs when the control is entered. (Inherited from Control.)
Public event FontChanged Occurs when the Font property value changes. (Inherited from Control.)
Public event ForeColorChanged Occurs when the ForeColor property value changes. (Inherited from Control.)
Public event GiveFeedback Occurs during a drag operation. (Inherited from Control.)
Public event GotFocus Occurs when the control receives focus. (Inherited from Control.)
Public event HandleCreated Occurs when a handle is created for the control. (Inherited from Control.)
Public event HandleDestroyed Occurs when the control's handle is in the process of being destroyed. (Inherited from Control.)
Public event HelpRequested Occurs when the user requests help for a control. (Inherited from Control.)
Public event ImeModeChanged Infrastructure. Occurs when the ImeMode property has changed.
Public event Invalidated Occurs when a control's display requires redrawing. (Inherited from Control.)
Public event KeyDown Occurs when a key is pressed while the control has focus. (Inherited from Control.)
Public event KeyPress Occurs when a key is pressed while the control has focus. (Inherited from Control.)
Public event KeyUp Occurs when a key is released while the control has focus. (Inherited from Control.)
Public event Layout Occurs when a control should reposition its child controls. (Inherited from Control.)
Public event Leave Occurs when the input focus leaves the control. (Inherited from Control.)
Public event LocationChanged Occurs when the Location property value has changed. (Inherited from Control.)
Public event LostFocus Occurs when the control loses focus. (Inherited from Control.)
Public event MarginChanged Occurs when the control's margin changes. (Inherited from Control.)
Public event MouseCaptureChanged Occurs when the control loses mouse capture. (Inherited from Control.)
Public event MouseClick Infrastructure. Occurs when the user clicks the MonthCalendar control with the mouse.
Public event MouseDoubleClick Infrastructure. Occurs when the user double-clicks the MonthCalendar control with the mouse.
Public event MouseDown Occurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control.)
Public event MouseEnter Occurs when the mouse pointer enters the control. (Inherited from Control.)
Public event MouseHover Occurs when the mouse pointer rests on the control. (Inherited from Control.)
Public event MouseLeave Occurs when the mouse pointer leaves the control. (Inherited from Control.)
Public event MouseMove Occurs when the mouse pointer is moved over the control. (Inherited from Control.)
Public event MouseUp Occurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control.)
Public event MouseWheel Occurs when the mouse wheel moves while the control has focus. (Inherited from Control.)
Public event Move Occurs when the control is moved. (Inherited from Control.)
Public event PaddingChanged Infrastructure. Occurs when the value of the Padding property changes.
Public event Paint Infrastructure. Occurs when the control is redrawn.
Public event ParentChanged Occurs when the Parent property value changes. (Inherited from Control.)
Public event PreviewKeyDown Occurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.)
Public event QueryAccessibilityHelp Occurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control.)
Public event QueryContinueDrag Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from Control.)
Public event RegionChanged Occurs when the value of the Region property changes. (Inherited from Control.)
Public event Resize Occurs when the control is resized. (Inherited from Control.)
Public event RightToLeftChanged Occurs when the RightToLeft property value changes. (Inherited from Control.)
Public event RightToLeftLayoutChanged Occurs when the value of the RightToLeftLayout property changes.
Public event SizeChanged Occurs when the Size property value changes. (Inherited from Control.)
Public event StyleChanged Occurs when the control style changes. (Inherited from Control.)
Public event SystemColorsChanged Occurs when the system colors change. (Inherited from Control.)
Public event TabIndexChanged Occurs when the TabIndex property value changes. (Inherited from Control.)
Public event TabStopChanged Occurs when the TabStop property value changes. (Inherited from Control.)
Public event TextChanged Infrastructure. Occurs when the value of the Text property changes.
Public event Validated Occurs when the control is finished validating. (Inherited from Control.)
Public event Validating Occurs when the control is validating. (Inherited from Control.)
Public event VisibleChanged Occurs when the Visible property value changes. (Inherited from Control.)
Top
  Name Description
Explicit interface implemetation Private method IDropTarget.OnDragDrop Infrastructure. Raises the DragDrop event. (Inherited from Control.)
Explicit interface implemetation Private method IDropTarget.OnDragEnter Infrastructure. Raises the DragEnter event. (Inherited from Control.)
Explicit interface implemetation Private method IDropTarget.OnDragLeave Infrastructure. Raises the DragLeave event. (Inherited from Control.)
Explicit interface implemetation Private method IDropTarget.OnDragOver Infrastructure. Raises the DragOver event. (Inherited from Control.)
Top

The MonthCalendar control allows the user to select a date using a visual display. You can limit the date and times that can be selected by setting the MinDate and MaxDate properties.

You can change the look of the calendar portion of the control by setting the ForeColor, Font, TitleBackColor, TitleForeColor, TrailingForeColor, and BackColor properties.

Note Note

The DateTimePicker control only supports Gregorian calendars.

The MonthCalendar control is drawn by the operating system, so the Paint event is never raised. If you need to provide a customized look to the MonthCalendar control, you should override the OnPrint method, call the base implementation of OnPrint, and then perform custom painting.

If you need custom date formatting and a selection limited to just one date, you might consider using a DateTimePicker control instead of a MonthCalendar. Using the DateTimePicker eliminates much of the need for validating date/time values.

For more information on month calendar controls, see Month Calendar Control Reference.

The following code example displays a form containing a MonthCalendar control that displays one calendar year. The example demonstrates setting the BackColor, ForeColor, TitleBackColor, TitleForeColor, CalendarDimensions, and TrailingForeColor properties to customize the look of the calendar control. Other properties such as AnnuallyBoldedDates, BoldedDates, and MonthlyBoldedDates are set to customize which dates are bold. The example also sets the FirstDayOfWeek, MaxDate, MinDate, and MaxSelectionCount properties to change the calendar format. The DateSelected and DateChanged events are also handled and their status is displayed on the form.


using System;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private System.Windows.Forms.MonthCalendar monthCalendar1;
    private System.Windows.Forms.TextBox textBox1;

    [STAThread]
    static void Main() 
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        this.textBox1 = new System.Windows.Forms.TextBox();
        this.textBox1.BorderStyle = System.Windows.Forms.BorderStyle.FixedSingle;
        this.textBox1.Location = new System.Drawing.Point(48, 488);
        this.textBox1.Multiline = true;
        this.textBox1.ReadOnly = true;
        this.textBox1.Size = new System.Drawing.Size(824, 32);

        // Create the calendar.
        this.monthCalendar1 = new System.Windows.Forms.MonthCalendar();

        // Set the calendar location.
        this.monthCalendar1.Location = new System.Drawing.Point(47, 16);

        // Change the color.
        this.monthCalendar1.BackColor = System.Drawing.SystemColors.Info;
        this.monthCalendar1.ForeColor = System.Drawing.Color.FromArgb(
                                 ((System.Byte)(192)), ((System.Byte)(0)), ((System.Byte)(192)));
        this.monthCalendar1.TitleBackColor = System.Drawing.Color.Purple;
        this.monthCalendar1.TitleForeColor = System.Drawing.Color.Yellow;
        this.monthCalendar1.TrailingForeColor = System.Drawing.Color.FromArgb(
                                 ((System.Byte)(192)), ((System.Byte)(192)), ((System.Byte)(0)));

        // Add dates to the AnnuallyBoldedDates array.
        this.monthCalendar1.AnnuallyBoldedDates = 
            new System.DateTime[] { new System.DateTime(2002, 4, 20, 0, 0, 0, 0),
                                    new System.DateTime(2002, 4, 28, 0, 0, 0, 0),
                                    new System.DateTime(2002, 5, 5, 0, 0, 0, 0),
                                    new System.DateTime(2002, 7, 4, 0, 0, 0, 0),
                                    new System.DateTime(2002, 12, 15, 0, 0, 0, 0),
                                    new System.DateTime(2002, 12, 18, 0, 0, 0, 0)};

        // Add dates to BoldedDates array.
        this.monthCalendar1.BoldedDates = new System.DateTime[] {new System.DateTime(2002, 9, 26, 0, 0, 0, 0)};

        // Add dates to MonthlyBoldedDates array.
        this.monthCalendar1.MonthlyBoldedDates = 
           new System.DateTime[] {new System.DateTime(2002, 1, 15, 0, 0, 0, 0),
                                  new System.DateTime(2002, 1, 30, 0, 0, 0, 0)};

        // Configure the calendar to display 3 rows by 4 columns of months.
        this.monthCalendar1.CalendarDimensions = new System.Drawing.Size(4, 3);

        // Set week to begin on Monday.
        this.monthCalendar1.FirstDayOfWeek = System.Windows.Forms.Day.Monday;

        // Set the maximum visible date on the calendar to 12/31/2010.
        this.monthCalendar1.MaxDate = new System.DateTime(2010, 12, 31, 0, 0, 0, 0);

        // Set the minimum visible date on calendar to 12/31/2010.
        this.monthCalendar1.MinDate = new System.DateTime(1999, 1, 1, 0, 0, 0, 0);

        // Only allow 21 days to be selected at the same time.
        this.monthCalendar1.MaxSelectionCount = 21;

        // Set the calendar to move one month at a time when navigating using the arrows.
        this.monthCalendar1.ScrollChange = 1;

        // Do not show the "Today" banner.
        this.monthCalendar1.ShowToday = false;

        // Do not circle today's date.
        this.monthCalendar1.ShowTodayCircle = false;

        // Show the week numbers to the left of each week.
        this.monthCalendar1.ShowWeekNumbers = true;

        // Add event handlers for the DateSelected and DateChanged events
        this.monthCalendar1.DateSelected += new System.Windows.Forms.DateRangeEventHandler(this.monthCalendar1_DateSelected);
        this.monthCalendar1.DateChanged += new System.Windows.Forms.DateRangeEventHandler(this.monthCalendar1_DateChanged);

        // Set up how the form should be displayed and add the controls to the form.
        this.ClientSize = new System.Drawing.Size(920, 566);
        this.Controls.AddRange(new System.Windows.Forms.Control[] {this.textBox1, this.monthCalendar1});
        this.Text = "Month Calendar Example";
    }

    private void monthCalendar1_DateSelected(object sender, System.Windows.Forms.DateRangeEventArgs e)
    {
        // Show the start and end dates in the text box.
        this.textBox1.Text = "Date Selected: Start = " +
            e.Start.ToShortDateString() + " : End = " + e.End.ToShortDateString();
    }

    private void monthCalendar1_DateChanged(object sender, System.Windows.Forms.DateRangeEventArgs e)
    {
        // Show the start and end dates in the text box.
        this.textBox1.Text = "Date Changed: Start =  " +
            e.Start.ToShortDateString() + " : End = " + e.End.ToShortDateString();
    }
}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ