CDateTimeCtrl Class

Encapsulates the functionality of a date and time picker control.

class CDateTimeCtrl : public CWnd

Members

Public Constructors

Name	Description
CDateTimeCtrl::CDateTimeCtrl	Constructs a CDateTimeCtrl object.

Public Methods

Name	Description
CDateTimeCtrl::CloseMonthCal	Closes the current date and time picker control.
CDateTimeCtrl::Create	Creates the date and time picker control and attaches it to the CDateTimeCtrl object.
CDateTimeCtrl::GetDateTimePickerInfo	Retrieves information about the current date and time picker control.
CDateTimeCtrl::GetIdealSize	Returns the ideal size of the date and time picker control that is required to display the current date or time.
CDateTimeCtrl::GetMonthCalColor	Retrieves the color for a given portion of the month calendar within the date and time picker control.
CDateTimeCtrl::GetMonthCalCtrl	Retrieves the CMonthCalCtrl object associated with the date and time picker control.
CDateTimeCtrl::GetMonthCalFont	Retrieves the font currently used by the date and time picker control's child month calendar control.
CDateTimeCtrl::GetMonthCalStyle	Gets the style of the current date and time picker control.
CDateTimeCtrl::GetRange	Retrieves the current minimum and maximum allowed system times for a date and time picker control.
CDateTimeCtrl::GetTime	Retrieves the currently selected time from a date and time picker control and puts it in a specified SYSTEMTIME structure.
CDateTimeCtrl::SetFormat	Sets the display of a date and time picker control in accordance with a given format string.
CDateTimeCtrl::SetMonthCalColor	Sets the color for a given portion of the month calendar within a date and time picker control.
CDateTimeCtrl::SetMonthCalFont	Sets the font that the date and time picker control's child month calendar control will use.
CDateTimeCtrl::SetMonthCalStyle	Sets the style of the current date and time picker control.
CDateTimeCtrl::SetRange	Sets the minimum and maximum allowed system times for a date and time picker control.
CDateTimeCtrl::SetTime	Sets the time in a date and time picker control.

Remarks

The date and time picker control (DTP control) provides a simple interface to exchange date and time information with a user. This interface contains fields, each of which displays a part of the date and time information stored in the control. The user can change the information stored in the control by changing the content of the string in a given field. The user can move from field to field using the mouse or the keyboard.

You can customize the date and time picker control by applying a variety of styles to the object when you create it. See Date and Time Picker Control Styles in the Windows SDK for more information about styles specific to the date and time picker control. You can set the display format of the DTP control using format styles. These format styles are described under "Format Styles" in the Windows SDK topic Date and Time Picker Control Styles.

The date and time picker control also uses notifications and callbacks, which are described in Using CDateTimeCtrl.

Inheritance Hierarchy

CObject

CCmdTarget

CWnd

CDateTimeCtrl

Requirements

Header: afxdtctl.h

See Also

Reference

CWnd Class

Hierarchy Chart

CMonthCalCtrl Class

Concepts

MFC Sample CMNCTRL1