DateTimePicker Class

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Represents a Windows control that allows the user to select a date and a time and to display the date and time with a specified format.

public ref class DateTimePicker : System::Windows::Forms::Control

[System.ComponentModel.DefaultBindingProperty("Value")]
public class DateTimePicker : System.Windows.Forms.Control

[<System.ComponentModel.DefaultBindingProperty("Value")>]
type DateTimePicker = class
    inherit Control

Public Class DateTimePicker
Inherits Control

Inheritance

Object

MarshalByRefObject

Component

Control

DateTimePicker

Attributes

DefaultBindingPropertyAttribute

Examples

The following code example creates an new instance of a DateTimePicker control and initializes it. The control's CustomFormat property is set. Also, the ShowCheckBox property is set so that the control displays a CheckBox, and the ShowUpDown property is set so that the control is displayed as a spin button control. To run this example, paste the following code into a form and call the CreateMyDateTimePicker method in the example form's constructor or Load event handling method.

public:
   void CreateMyDateTimePicker()
   {
      // Create a new DateTimePicker control and initialize it.
      DateTimePicker^ dateTimePicker1 = gcnew DateTimePicker;
      
      // Set the MinDate and MaxDate.
      dateTimePicker1->MinDate = DateTime(1985,6,20);
      dateTimePicker1->MaxDate = DateTime::Today;
      
      // Set the CustomFormat string.
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      
      // Show the CheckBox and display the control as an up-down control.
      dateTimePicker1->ShowCheckBox = true;
      dateTimePicker1->ShowUpDown = true;
   }

public void CreateMyDateTimePicker()
{
   // Create a new DateTimePicker control and initialize it.
   DateTimePicker dateTimePicker1 = new DateTimePicker();

   // Set the MinDate and MaxDate.
   dateTimePicker1.MinDate = new DateTime(1985, 6, 20);
   dateTimePicker1.MaxDate = DateTime.Today;

   // Set the CustomFormat string.
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
   dateTimePicker1.Format = DateTimePickerFormat.Custom;

   // Show the CheckBox and display the control as an up-down control.
   dateTimePicker1.ShowCheckBox = true;
   dateTimePicker1.ShowUpDown = true;
}

Public Sub CreateMyDateTimePicker()
    ' Create a new DateTimePicker control and initialize it.
    Dim dateTimePicker1 As New DateTimePicker()
    
    ' Set the MinDate and MaxDate.
    dateTimePicker1.MinDate = New DateTime(1985, 6, 20)
    dateTimePicker1.MaxDate = DateTime.Today
    
    ' Set the CustomFormat string.
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    
    ' Show the CheckBox and display the control as an up-down control.
    dateTimePicker1.ShowCheckBox = True
    dateTimePicker1.ShowUpDown = True
End Sub

Remarks

The DateTimePicker control is used to allow the user to select a date and time, and to display that date and time in the specified format. The DateTimePicker control makes it easy to work with dates and times because it handles a lot of the data validation automatically.

Note

The DateTimePicker control only supports Gregorian calendars.

When used to represent a date, the DateTimePicker control appears in two parts: a drop-down list with a date represented in text, and a calendar that appears when you click the down-arrow next to the list. The calendar looks like the MonthCalendar control, which can be used for selecting multiple dates. For more information about the MonthCalendar control, see MonthCalendar Control Overview.

You can change the look of the calendar portion of the control by setting the CalendarForeColor, CalendarFont, CalendarTitleBackColor, CalendarTitleForeColor, CalendarTrailingForeColor, and CalendarMonthBackground properties.

To use a spin button control (also known as an up-down control) to adjust the date/time value, set the ShowUpDown property to true. The calendar will not drop down when the control is selected. The date and time can be adjusted by selecting each element individually and using the up and down buttons to change the value.

The Value property contains the current date and time the control is set to. You can use the Text property or the appropriate member of Value to get the date and time value. For more information, see How to: Set and Return Dates with the Windows Forms DateTimePicker Control. You can limit the dates and times that can be selected by setting the MinDate and MaxDate properties.

The values can be displayed in four formats, which are set by the Format property: Long, Short, Time, or Custom. The default date Format is DateTimePickerFormat.Long.

If you want the DateTimePicker to appear as a control for picking or editing times instead of dates, set the ShowUpDown property to true and the Format property to Time. For more information, see How to: Display Time with the DateTimePicker Control.

If the Format property is set to DateTimePickerFormat.Custom, you can create your own format style by setting the CustomFormat property and building a custom format string. The custom format string can be a combination of custom field characters and other literal characters. For example, you can display the date as "June 01, 2012 - Friday" by setting the CustomFormat property to "MMMM dd, yyyy - dddd". For more information, see How to: Display a Date in a Custom Format with the Windows Forms DateTimePicker Control and Custom Date and Time Format Strings.

Caution

When a DateTimePicker is data-bound and the backing value is changed to null, the value of the DateTimePicker will not be updated and the previous value will be retained. In situations where this behavior is not desirable (for example, when using a set of data-bound controls to page through a recordset) use the Format event of the Binding class to set the DateTimePicker to a value recognizable as a null.

Constructors

DateTimePicker()

Initializes a new instance of the DateTimePicker class.

Fields

DefaultMonthBackColor	Specifies the default month background color of the DateTimePicker control. This field is read-only.
DefaultTitleBackColor	Specifies the default title back color of the DateTimePicker control. This field is read-only.
DefaultTitleForeColor	Specifies the default title foreground color of the DateTimePicker control. This field is read-only.
DefaultTrailingForeColor	Specifies the default trailing foreground color of the DateTimePicker control. This field is read-only.
MaxDateTime	Specifies the maximum date value of the DateTimePicker control. This field is read-only.
MinDateTime	Gets the minimum date value of the DateTimePicker control.

Properties

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)
AllowDrop	Gets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control)
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)
AutoScrollOffset	Gets or sets where this control is scrolled to in ScrollControlIntoView(Control). (Inherited from Control)
AutoSize	This property is not relevant for this class. (Inherited from Control)
BackColor	Gets or sets a value indicating the background color of the DateTimePicker control.
BackgroundImage	Gets or sets the background image for the control.
BackgroundImageLayout	Gets or sets the layout of the background image of the DateTimePicker control.
BindingContext	Gets or sets the BindingContext for the control. (Inherited from Control)
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)
CalendarFont	Gets or sets the font style applied to the calendar.
CalendarForeColor	Gets or sets the foreground color of the calendar.
CalendarMonthBackground	Gets or sets the background color of the calendar month.
CalendarTitleBackColor	Gets or sets the background color of the calendar title.
CalendarTitleForeColor	Gets or sets the foreground color of the calendar title.
CalendarTrailingForeColor	Gets or sets the foreground color of the calendar trailing dates.
CanEnableIme	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	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)
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)
Checked	Gets or sets a value indicating whether the Value property has been set with a valid date/time value and the displayed value is able to be updated.
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)
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)
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)
Created	Gets a value indicating whether the control has been created. (Inherited from Control)
CreateParams	Gets the required creation parameters when the control handle is created.
Cursor	Gets or sets the cursor that is displayed when the mouse pointer is over the control. (Inherited from Control)
CustomFormat	Gets or sets the custom date/time format string.
DataBindings	Gets the data bindings for the control. (Inherited from Control)
DataContext	Gets or sets the data context for the purpose of data binding. This is an ambient property. (Inherited from Control)
DefaultCursor	Gets or sets the default cursor for the control. (Inherited from Control)
DefaultImeMode	Gets the default Input Method Editor (IME) mode supported by the control. (Inherited from Control)
DefaultMargin	Gets the space, in pixels, that is specified by default between controls. (Inherited from Control)
DefaultMaximumSize	Gets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control)
DefaultMinimumSize	Gets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control)
DefaultPadding	Gets the default internal spacing, in pixels, of the contents of a control. (Inherited from Control)
DefaultSize	Gets the default size of the control.
DesignMode	Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component)
DeviceDpi	Gets the DPI value for the display device where the control is currently being displayed. (Inherited from Control)
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	Gets or sets a value indicating whether the control should redraw its surface using a secondary buffer. Setting this property has no effect on the DateTimePicker control.
DropDownAlign	Gets or sets the alignment of the drop-down calendar on the DateTimePicker control.
Enabled	Gets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control)
Events	Gets the list of event handlers that are attached to this Component. (Inherited from Component)
Focused	Gets a value indicating whether the control has input focus. (Inherited from Control)
Font	Gets or sets the font of the text displayed by the control. (Inherited from Control)
FontHeight	Gets or sets the height of the font of the control. (Inherited from Control)
ForeColor	Gets or sets the foreground color of the DateTimePicker control.
Format	Gets or sets the format of the date and time displayed in the control.
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)
Height	Gets or sets the height of the control. (Inherited from Control)
ImeMode	Gets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control)
ImeModeBase	Gets or sets the IME mode of a control. (Inherited from Control)
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)
IsAncestorSiteInDesignMode	Indicates if one of the Ancestors of this control is sited and that site in DesignMode. This property is read-only. (Inherited from Control)
IsDisposed	Gets a value indicating whether the control has been disposed of. (Inherited from Control)
IsHandleCreated	Gets a value indicating whether the control has a handle associated with it. (Inherited from Control)
IsMirrored	Gets a value indicating whether the control is mirrored. (Inherited from Control)
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)
Margin	Gets or sets the space between controls. (Inherited from Control)
MaxDate	Gets or sets the maximum date and time that can be selected in the control.
MaximumDateTime	Gets the maximum date value allowed for the DateTimePicker control.
MaximumSize	Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify. (Inherited from Control)
MinDate	Gets or sets the minimum date and time that can be selected in the control.
MinimumDateTime	Gets the minimum date value allowed for the DateTimePicker control.
MinimumSize	Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify. (Inherited from Control)
Name	Gets or sets the name of the control. (Inherited from Control)
Padding	Gets or sets the spacing between the contents of the DateTimePicker control and its edges.
Parent	Gets or sets the parent container of the control. (Inherited from Control)
PreferredHeight	Gets the preferred height of the DateTimePicker 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)
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	Obsolete. This property is now obsolete. (Inherited from Control)
ResizeRedraw	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 contents of the DateTimePicker are laid out from right to left.
ScaleChildren	Gets a value that determines the scaling of child controls. (Inherited from Control)
ShowCheckBox	Gets or sets a value indicating whether a check box is displayed to the left of the selected date.
ShowFocusCues	Gets a value indicating whether the control should display focus rectangles. (Inherited from Control)
ShowKeyboardCues	Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control)
ShowUpDown	Gets or sets a value indicating whether a spin button control (also known as an up-down control) is used to adjust the date/time value.
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)
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	Gets or sets the text associated with this control.
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)
UseWaitCursor	Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control)
Value	Gets or sets the date/time value assigned to the control.
Visible	Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control)
Width	Gets or sets the width of the control. (Inherited from Control)
WindowTarget	This property is not relevant for this class. (Inherited from Control)

Methods

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control)
AccessibilityNotifyClients(AccessibleEvents, Int32)	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control)
BeginInvoke(Action)	Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control)
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)
BeginInvoke(Delegate)	Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control)
BringToFront()	Brings the control to the front of the z-order. (Inherited from Control)
Contains(Control)	Retrieves a value indicating whether the specified control is a child of the control. (Inherited from Control)
CreateAccessibilityInstance()	Creates a new accessibility object for the DateTimePicker control.
CreateControl()	Forces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control)
CreateControlsInstance()	Creates a new instance of the control collection for the control. (Inherited from Control)
CreateGraphics()	Creates the Graphics for the control. (Inherited from Control)
CreateHandle()	Creates the physical window handle.
CreateObjRef(Type)	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject)
DefWndProc(Message)	Sends the specified message to the default window procedure. (Inherited from Control)
DestroyHandle()	Destroys the physical window handle.
Dispose()	Releases all resources used by the Component. (Inherited from Component)
Dispose(Boolean)	Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources. (Inherited from Control)
DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean)	Begins a drag operation. (Inherited from Control)
DoDragDrop(Object, DragDropEffects)	Begins a drag-and-drop operation. (Inherited from Control)
DrawToBitmap(Bitmap, Rectangle)	Supports rendering to the specified bitmap. (Inherited from Control)
EndInvoke(IAsyncResult)	Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
FindForm()	Retrieves the form that the control is on. (Inherited from Control)
Focus()	Sets input focus to the control. (Inherited from Control)
GetAccessibilityObjectById(Int32)	Retrieves the specified AccessibleObject. (Inherited from Control)
GetAutoSizeMode()	Retrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control)
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)
GetChildAtPoint(Point)	Retrieves the child control that is located at the specified coordinates. (Inherited from Control)
GetContainerControl()	Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetLifetimeService()	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject)
GetNextControl(Control, Boolean)	Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control)
GetPreferredSize(Size)	Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control)
GetScaledBounds(Rectangle, SizeF, BoundsSpecified)	Retrieves the bounds within which the control is scaled. (Inherited from Control)
GetService(Type)	Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component)
GetStyle(ControlStyles)	Retrieves the value of the specified control style bit for the control. (Inherited from Control)
GetTopLevel()	Determines if the control is a top-level control. (Inherited from Control)
GetType()	Gets the Type of the current instance. (Inherited from Object)
Hide()	Conceals the control from the user. (Inherited from Control)
InitializeLifetimeService()	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject)
InitLayout()	Called after the control has been added to another container. (Inherited from Control)
Invalidate()	Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control)
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)
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)
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)
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)
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)
Invoke(Action)	Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control)
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)
Invoke(Delegate)	Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control)
Invoke<T>(Func<T>)	Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control)
InvokeAsync(Action, CancellationToken)	Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle. (Inherited from Control)
InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken)	Executes the specified asynchronous callback on the thread that owns the control's handle asynchronously. (Inherited from Control)
InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken)	Executes the specified asynchronous callback on the thread that owns the control's handle. (Inherited from Control)
InvokeAsync<T>(Func<T>, CancellationToken)	Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle. (Inherited from Control)
InvokeGotFocus(Control, EventArgs)	Raises the GotFocus event for the specified control. (Inherited from Control)
InvokeLostFocus(Control, EventArgs)	Raises the LostFocus event for the specified control. (Inherited from Control)
InvokeOnClick(Control, EventArgs)	Raises the Click event for the specified control. (Inherited from Control)
InvokePaint(Control, PaintEventArgs)	Raises the Paint event for the specified control. (Inherited from Control)
InvokePaintBackground(Control, PaintEventArgs)	Raises the PaintBackground event for the specified control. (Inherited from Control)
IsInputChar(Char)	Determines if a character is an input character that the control recognizes. (Inherited from Control)
IsInputKey(Keys)	Determines whether the specified key is a regular input key or a special key that requires preprocessing.
LogicalToDeviceUnits(Int32)	Converts a Logical DPI value to its equivalent DeviceUnit DPI value. (Inherited from Control)
LogicalToDeviceUnits(Size)	Transforms a size from logical to device units by scaling it for the current DPI and rounding down to the nearest integer value for width and height. (Inherited from Control)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject)
NotifyInvalidate(Rectangle)	Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control)
OnAutoSizeChanged(EventArgs)	Raises the AutoSizeChanged event. (Inherited from Control)
OnBackColorChanged(EventArgs)	Raises the BackColorChanged event. (Inherited from Control)
OnBackgroundImageChanged(EventArgs)	Raises the BackgroundImageChanged event. (Inherited from Control)
OnBackgroundImageLayoutChanged(EventArgs)	Raises the BackgroundImageLayoutChanged event. (Inherited from Control)
OnBindingContextChanged(EventArgs)	Raises the BindingContextChanged event. (Inherited from Control)
OnCausesValidationChanged(EventArgs)	Raises the CausesValidationChanged event. (Inherited from Control)
OnChangeUICues(UICuesEventArgs)	Raises the ChangeUICues event. (Inherited from Control)
OnClick(EventArgs)	Raises the Click event. (Inherited from Control)
OnClientSizeChanged(EventArgs)	Raises the ClientSizeChanged event. (Inherited from Control)
OnCloseUp(EventArgs)	Raises the CloseUp event.
OnContextMenuChanged(EventArgs)	Raises the ContextMenuChanged event. (Inherited from Control)
OnContextMenuStripChanged(EventArgs)	Raises the ContextMenuStripChanged event. (Inherited from Control)
OnControlAdded(ControlEventArgs)	Raises the ControlAdded event. (Inherited from Control)
OnControlRemoved(ControlEventArgs)	Raises the ControlRemoved event. (Inherited from Control)
OnCreateControl()	Raises the CreateControl() method. (Inherited from Control)
OnCursorChanged(EventArgs)	Raises the CursorChanged event. (Inherited from Control)
OnDataContextChanged(EventArgs)	(Inherited from Control)
OnDockChanged(EventArgs)	Raises the DockChanged event. (Inherited from Control)
OnDoubleClick(EventArgs)	Raises the DoubleClick event. (Inherited from Control)
OnDpiChangedAfterParent(EventArgs)	Raises the DpiChangedAfterParent event. (Inherited from Control)
OnDpiChangedBeforeParent(EventArgs)	Raises the DpiChangedBeforeParent event. (Inherited from Control)
OnDragDrop(DragEventArgs)	Raises the DragDrop event. (Inherited from Control)
OnDragEnter(DragEventArgs)	Raises the DragEnter event. (Inherited from Control)
OnDragLeave(EventArgs)	Raises the DragLeave event. (Inherited from Control)
OnDragOver(DragEventArgs)	Raises the DragOver event. (Inherited from Control)
OnDropDown(EventArgs)	Raises the DropDown event.
OnEnabledChanged(EventArgs)
OnEnter(EventArgs)	Raises the Enter event. (Inherited from Control)
OnFontChanged(EventArgs)	Raises the FontChanged event.
OnForeColorChanged(EventArgs)	Raises the ForeColorChanged event. (Inherited from Control)
OnFormatChanged(EventArgs)	Raises the FormatChanged event.
OnGiveFeedback(GiveFeedbackEventArgs)	Raises the GiveFeedback event. (Inherited from Control)
OnGotFocus(EventArgs)
OnHandleCreated(EventArgs)	Raises the HandleCreated event.
OnHandleDestroyed(EventArgs)	Raises the HandleDestroyed event.
OnHelpRequested(HelpEventArgs)	Raises the HelpRequested event. (Inherited from Control)
OnImeModeChanged(EventArgs)	Raises the ImeModeChanged event. (Inherited from Control)
OnInvalidated(InvalidateEventArgs)	Raises the Invalidated event. (Inherited from Control)
OnKeyDown(KeyEventArgs)	Raises the KeyDown event. (Inherited from Control)
OnKeyPress(KeyPressEventArgs)	Raises the KeyPress event. (Inherited from Control)
OnKeyUp(KeyEventArgs)	Raises the KeyUp event. (Inherited from Control)
OnLayout(LayoutEventArgs)	Raises the Layout event. (Inherited from Control)
OnLeave(EventArgs)	Raises the Leave event. (Inherited from Control)
OnLocationChanged(EventArgs)	Raises the LocationChanged event. (Inherited from Control)
OnLostFocus(EventArgs)	Raises the LostFocus event. (Inherited from Control)
OnMarginChanged(EventArgs)	Raises the MarginChanged event. (Inherited from Control)
OnMouseCaptureChanged(EventArgs)	Raises the MouseCaptureChanged event. (Inherited from Control)
OnMouseClick(MouseEventArgs)	Raises the MouseClick event. (Inherited from Control)
OnMouseDoubleClick(MouseEventArgs)	Raises the MouseDoubleClick event. (Inherited from Control)
OnMouseDown(MouseEventArgs)	Raises the MouseDown event. (Inherited from Control)
OnMouseEnter(EventArgs)	Raises the MouseEnter event. (Inherited from Control)
OnMouseHover(EventArgs)	Raises the MouseHover event. (Inherited from Control)
OnMouseLeave(EventArgs)	Raises the MouseLeave event. (Inherited from Control)
OnMouseMove(MouseEventArgs)	Raises the MouseMove event. (Inherited from Control)
OnMouseUp(MouseEventArgs)	Raises the MouseUp event. (Inherited from Control)
OnMouseWheel(MouseEventArgs)	Raises the MouseWheel event. (Inherited from Control)
OnMove(EventArgs)	Raises the Move event. (Inherited from Control)
OnNotifyMessage(Message)	Notifies the control of Windows messages. (Inherited from Control)
OnPaddingChanged(EventArgs)	Raises the PaddingChanged event. (Inherited from Control)
OnPaint(PaintEventArgs)	Raises the Paint event. (Inherited from Control)
OnPaintBackground(PaintEventArgs)	Paints the background of the control. (Inherited from Control)
OnParentBackColorChanged(EventArgs)	Raises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control)
OnParentBackgroundImageChanged(EventArgs)	Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control)
OnParentBindingContextChanged(EventArgs)	Raises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control)
OnParentChanged(EventArgs)	Raises the ParentChanged event. (Inherited from Control)
OnParentCursorChanged(EventArgs)	Raises the CursorChanged event. (Inherited from Control)
OnParentDataContextChanged(EventArgs)	(Inherited from Control)
OnParentEnabledChanged(EventArgs)	Raises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control)
OnParentFontChanged(EventArgs)	Raises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control)
OnParentForeColorChanged(EventArgs)	Raises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control)
OnParentRightToLeftChanged(EventArgs)	Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control)
OnParentVisibleChanged(EventArgs)	Raises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control)
OnPreviewKeyDown(PreviewKeyDownEventArgs)	Raises the PreviewKeyDown event. (Inherited from Control)
OnPrint(PaintEventArgs)	Raises the Paint event. (Inherited from Control)
OnQueryContinueDrag(QueryContinueDragEventArgs)	Raises the QueryContinueDrag event. (Inherited from Control)
OnRegionChanged(EventArgs)	Raises the RegionChanged event. (Inherited from Control)
OnResize(EventArgs)	Raises the Resize event. (Inherited from Control)
OnRightToLeftChanged(EventArgs)	Raises the RightToLeftChanged event. (Inherited from Control)
OnRightToLeftLayoutChanged(EventArgs)	Raises the RightToLeftLayout event.
OnSizeChanged(EventArgs)	Raises the SizeChanged event. (Inherited from Control)
OnStyleChanged(EventArgs)	Raises the StyleChanged event. (Inherited from Control)
OnSystemColorsChanged(EventArgs)	Overrides the OnSystemColorsChanged(EventArgs) method.
OnTabIndexChanged(EventArgs)	Raises the TabIndexChanged event. (Inherited from Control)
OnTabStopChanged(EventArgs)	Raises the TabStopChanged event. (Inherited from Control)
OnTextChanged(EventArgs)	Raises the TextChanged event. (Inherited from Control)
OnValidated(EventArgs)	Raises the Validated event. (Inherited from Control)
OnValidating(CancelEventArgs)	Raises the Validating event. (Inherited from Control)
OnValueChanged(EventArgs)	Raises the ValueChanged event.
OnVisibleChanged(EventArgs)	Raises the VisibleChanged event. (Inherited from Control)
PerformLayout()	Forces the control to apply layout logic to all its child controls. (Inherited from Control)
PerformLayout(Control, String)	Forces the control to apply layout logic to all its child controls. (Inherited from Control)
PointToClient(Point)	Computes the location of the specified screen point into client coordinates. (Inherited from Control)
PointToScreen(Point)	Computes the location of the specified client point into screen coordinates. (Inherited from Control)
PreProcessControlMessage(Message)	Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control)
PreProcessMessage(Message)	Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control)
ProcessCmdKey(Message, Keys)	Processes a command key. (Inherited from Control)
ProcessDialogChar(Char)	Processes a dialog character. (Inherited from Control)
ProcessDialogKey(Keys)	Processes a dialog key. (Inherited from Control)
ProcessKeyEventArgs(Message)	Processes a key message and generates the appropriate control events. (Inherited from Control)
ProcessKeyMessage(Message)	Processes a keyboard message. (Inherited from Control)
ProcessKeyPreview(Message)	Previews a keyboard message. (Inherited from Control)
ProcessMnemonic(Char)	Processes a mnemonic character. (Inherited from Control)
RaiseDragEvent(Object, DragEventArgs)	Raises the appropriate drag event. (Inherited from Control)
RaiseKeyEvent(Object, KeyEventArgs)	Raises the appropriate key event. (Inherited from Control)
RaiseMouseEvent(Object, MouseEventArgs)	Raises the appropriate mouse event. (Inherited from Control)
RaisePaintEvent(Object, PaintEventArgs)	Raises the appropriate paint event. (Inherited from Control)
RecreateHandle()	Forces the re-creation of the handle for the control. (Inherited from Control)
RectangleToClient(Rectangle)	Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control)
RectangleToScreen(Rectangle)	Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control)
Refresh()	Forces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Control)
RescaleConstantsForDpi(Int32, Int32)	Provides constants for rescaling the control when a DPI change occurs. (Inherited from Control)
ResetBackColor()	Resets the BackColor property to its default value. (Inherited from Control)
ResetBindings()	Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control)
ResetCursor()	Resets the Cursor property to its default value. (Inherited from Control)
ResetFont()	Resets the Font property to its default value. (Inherited from Control)
ResetForeColor()	Resets the ForeColor property to its default value. (Inherited from Control)
ResetImeMode()	Resets the ImeMode property to its default value. (Inherited from Control)
ResetMouseEventArgs()	Resets the control to handle the MouseLeave event. (Inherited from Control)
ResetRightToLeft()	Resets the RightToLeft property to its default value. (Inherited from Control)
ResetText()	Resets the Text property to its default value (Empty). (Inherited from Control)
ResumeLayout()	Resumes usual layout logic. (Inherited from Control)
ResumeLayout(Boolean)	Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control)
RtlTranslateAlignment(ContentAlignment)	Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control)
RtlTranslateAlignment(HorizontalAlignment)	Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control)
RtlTranslateAlignment(LeftRightAlignment)	Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control)
RtlTranslateContent(ContentAlignment)	Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control)
RtlTranslateHorizontal(HorizontalAlignment)	Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control)
RtlTranslateLeftRight(LeftRightAlignment)	Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control)
Scale(Single, Single)	Obsolete. Scales the entire control and any child controls. (Inherited from Control)
Scale(Single)	Obsolete. Scales the control and any child controls. (Inherited from Control)
Scale(SizeF)	Scales the control and all child controls by the specified scaling factor. (Inherited from Control)
ScaleBitmapLogicalToDevice(Bitmap)	Scales a logical bitmap value to it's equivalent device unit value when a DPI change occurs. (Inherited from Control)
ScaleControl(SizeF, BoundsSpecified)	Scales a control's location, size, padding and margin. (Inherited from Control)
ScaleCore(Single, Single)	This method is not relevant for this class. (Inherited from Control)
Select()	Activates the control. (Inherited from Control)
Select(Boolean, Boolean)	Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from Control)
SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean)	Activates the next control. (Inherited from Control)
SendToBack()	Sends the control to the back of the z-order. (Inherited from Control)
SetAutoSizeMode(AutoSizeMode)	Sets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)	Sets the specified bounds of the control to the specified location and size. (Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32)	Sets the bounds of the control to the specified location and size. (Inherited from Control)
SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)	Performs the work of setting the specified bounds of this control. (Inherited from Control)
SetClientSizeCore(Int32, Int32)	Sets the size of the client area of the control. (Inherited from Control)
SetStyle(ControlStyles, Boolean)	Sets a specified ControlStyles flag to either true or false. (Inherited from Control)
SetTopLevel(Boolean)	Sets the control as the top-level control. (Inherited from Control)
SetVisibleCore(Boolean)	Sets the control to the specified visible state. (Inherited from Control)
Show()	Displays the control to the user. (Inherited from Control)
SizeFromClientSize(Size)	Determines the size of the entire control from the height and width of its client area. (Inherited from Control)
SuspendLayout()	Temporarily suspends the layout logic for the control. (Inherited from Control)
ToString()	Returns a string that represents the current DateTimePicker control.
Update()	Causes the control to redraw the invalidated regions within its client area. (Inherited from Control)
UpdateBounds()	Updates the bounds of the control with the current size and location. (Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)	Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32)	Updates the bounds of the control with the specified size and location. (Inherited from Control)
UpdateStyles()	Forces the assigned styles to be reapplied to the control. (Inherited from Control)
UpdateZOrder()	Updates the control in its parent's z-order. (Inherited from Control)
WndProc(Message)	Processes Windows messages.

Events

AutoSizeChanged	This event is not relevant for this class. (Inherited from Control)
BackColorChanged	Occurs when the value of the BackColor property changes.
BackgroundImageChanged	Occurs when the value of the BackgroundImage property changes.
BackgroundImageLayoutChanged	Occurs when the value of the BackgroundImageLayout property changes.
BindingContextChanged	Occurs when the value of the BindingContext property changes. (Inherited from Control)
CausesValidationChanged	Occurs when the value of the CausesValidation property changes. (Inherited from Control)
ChangeUICues	Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control)
Click	Occurs when the control is clicked.
ClientSizeChanged	Occurs when the value of the ClientSize property changes. (Inherited from Control)
CloseUp	Occurs when the drop-down calendar is dismissed and disappears.
ContextMenuChanged	Occurs when the value of the ContextMenu property changes. (Inherited from Control)
ContextMenuStripChanged	Occurs when the value of the ContextMenuStrip property changes. (Inherited from Control)
ControlAdded	Occurs when a new control is added to the Control.ControlCollection. (Inherited from Control)
ControlRemoved	Occurs when a control is removed from the Control.ControlCollection. (Inherited from Control)
CursorChanged	Occurs when the value of the Cursor property changes. (Inherited from Control)
DataContextChanged	Occurs when the value of the DataContext property changes. (Inherited from Control)
Disposed	Occurs when the component is disposed by a call to the Dispose() method. (Inherited from Component)
DockChanged	Occurs when the value of the Dock property changes. (Inherited from Control)
DoubleClick	Occurs when the control is double-clicked.
DpiChangedAfterParent	Occurs when the DPI setting for a control is changed programmatically after the DPI of its parent control or form has changed. (Inherited from Control)
DpiChangedBeforeParent	Occurs when the DPI setting for a control is changed programmatically before a DPI change event for its parent control or form has occurred. (Inherited from Control)
DragDrop	Occurs when a drag-and-drop operation is completed. (Inherited from Control)
DragEnter	Occurs when an object is dragged into the control's bounds. (Inherited from Control)
DragLeave	Occurs when an object is dragged out of the control's bounds. (Inherited from Control)
DragOver	Occurs when an object is dragged over the control's bounds. (Inherited from Control)
DropDown	Occurs when the drop-down calendar is shown.
EnabledChanged	Occurs when the Enabled property value has changed. (Inherited from Control)
Enter	Occurs when the control is entered. (Inherited from Control)
FontChanged	Occurs when the Font property value changes. (Inherited from Control)
ForeColorChanged	Occurs when the value of the ForeColor property changes.
FormatChanged	Occurs when the Format property value has changed.
GiveFeedback	Occurs during a drag operation. (Inherited from Control)
GotFocus	Occurs when the control receives focus. (Inherited from Control)
HandleCreated	Occurs when a handle is created for the control. (Inherited from Control)
HandleDestroyed	Occurs when the control's handle is in the process of being destroyed. (Inherited from Control)
HelpRequested	Occurs when the user requests help for a control. (Inherited from Control)
ImeModeChanged	Occurs when the ImeMode property has changed. (Inherited from Control)
Invalidated	Occurs when a control's display requires redrawing. (Inherited from Control)
KeyDown	Occurs when a key is pressed while the control has focus. (Inherited from Control)
KeyPress	Occurs when a character, space, or backspace key is pressed while the control has focus. (Inherited from Control)
KeyUp	Occurs when a key is released while the control has focus. (Inherited from Control)
Layout	Occurs when a control should reposition its child controls. (Inherited from Control)
Leave	Occurs when the input focus leaves the control. (Inherited from Control)
LocationChanged	Occurs when the Location property value has changed. (Inherited from Control)
LostFocus	Occurs when the control loses focus. (Inherited from Control)
MarginChanged	Occurs when the control's margin changes. (Inherited from Control)
MouseCaptureChanged	Occurs when the control loses mouse capture. (Inherited from Control)
MouseClick	Occurs when the control is clicked with the mouse.
MouseDoubleClick	Occurs when the control is double-clicked with the mouse.
MouseDown	Occurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control)
MouseEnter	Occurs when the mouse pointer enters the control. (Inherited from Control)
MouseHover	Occurs when the mouse pointer rests on the control. (Inherited from Control)
MouseLeave	Occurs when the mouse pointer leaves the control. (Inherited from Control)
MouseMove	Occurs when the mouse pointer is moved over the control. (Inherited from Control)
MouseUp	Occurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control)
MouseWheel	Occurs when the mouse wheel moves while the control has focus. (Inherited from Control)
Move	Occurs when the control is moved. (Inherited from Control)
PaddingChanged	Occurs when the value of the Padding property changes.
Paint	Occurs when the control is redrawn.
ParentChanged	Occurs when the Parent property value changes. (Inherited from Control)
PreviewKeyDown	Occurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control)
QueryAccessibilityHelp	Occurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control)
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)
RegionChanged	Occurs when the value of the Region property changes. (Inherited from Control)
Resize	Occurs when the control is resized. (Inherited from Control)
RightToLeftChanged	Occurs when the RightToLeft property value changes. (Inherited from Control)
RightToLeftLayoutChanged	Occurs when the RightToLeftLayout property changes.
SizeChanged	Occurs when the Size property value changes. (Inherited from Control)
StyleChanged	Occurs when the control style changes. (Inherited from Control)
SystemColorsChanged	Occurs when the system colors change. (Inherited from Control)
TabIndexChanged	Occurs when the TabIndex property value changes. (Inherited from Control)
TabStopChanged	Occurs when the TabStop property value changes. (Inherited from Control)
TextChanged	Occurs when the value of the Text property changes.
Validated	Occurs when the control is finished validating. (Inherited from Control)
Validating	Occurs when the control is validating. (Inherited from Control)
ValueChanged	Occurs when the Value property changes.
VisibleChanged	Occurs when the Visible property value changes. (Inherited from Control)

Explicit Interface Implementations

IDropTarget.OnDragDrop(DragEventArgs)	Raises the DragDrop event. (Inherited from Control)
IDropTarget.OnDragEnter(DragEventArgs)	Raises the DragEnter event. (Inherited from Control)
IDropTarget.OnDragLeave(EventArgs)	Raises the DragLeave event. (Inherited from Control)
IDropTarget.OnDragOver(DragEventArgs)	Raises the DragOver event. (Inherited from Control)

See also

• MonthCalendar
• How to: Set and Return Dates with the Windows Forms DateTimePicker Control
• How to: Display Time with the DateTimePicker Control
• How to: Display a Date in a Custom Format with the Windows Forms DateTimePicker Control
• Custom Date and Time Format Strings