#include <wx/datectrl.h>
This control allows the user to select a date.
Unlike wxCalendarCtrl, which is a relatively big control, wxDatePickerCtrl is implemented as a small window showing the currently selected date. The control can be edited using the keyboard, and can also display a popup window for more user-friendly date selection, depending on the styles used and the platform, except PalmOS where date is selected using native dialog.
It is only available if wxUSE_DATEPICKCTRL
is set to 1.
This class supports the following styles:
The following event handler macros redirect the events to member function handlers 'func' with prototypes like:
Event macros for events emitted by this class:
![]() | ![]() | ![]() |
wxMSW appearance | wxGTK appearance | wxMac appearance |
Public Member Functions | |
wxDatePickerCtrl (wxWindow *parent, wxWindowID id, const wxDateTime &dt=wxDefaultDateTime, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxDP_DEFAULT|wxDP_SHOWCENTURY, const wxValidator &validator=wxDefaultValidator, const wxString &name="datectrl") | |
Initializes the object and calls Create() with all the parameters. | |
bool | Create (wxWindow *parent, wxWindowID id, const wxDateTime &dt=wxDefaultDateTime, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxDP_DEFAULT|wxDP_SHOWCENTURY, const wxValidator &validator=wxDefaultValidator, const wxString &name="datectrl") |
virtual bool | GetRange (wxDateTime *dt1, wxDateTime *dt2) const =0 |
If the control had been previously limited to a range of dates using SetRange(), returns the lower and upper bounds of this range. | |
virtual wxDateTime | GetValue () const =0 |
Returns the currently selected. | |
virtual void | SetRange (const wxDateTime &dt1, const wxDateTime &dt2)=0 |
Sets the valid range for the date selection. | |
virtual void | SetValue (const wxDateTime &dt)=0 |
Changes the current value of the control. |
wxDatePickerCtrl::wxDatePickerCtrl | ( | wxWindow * | parent, | |
wxWindowID | id, | |||
const wxDateTime & | dt = wxDefaultDateTime , |
|||
const wxPoint & | pos = wxDefaultPosition , |
|||
const wxSize & | size = wxDefaultSize , |
|||
long | style = wxDP_DEFAULT|wxDP_SHOWCENTURY , |
|||
const wxValidator & | validator = wxDefaultValidator , |
|||
const wxString & | name = "datectrl" | |||
) |
Initializes the object and calls Create() with all the parameters.
bool wxDatePickerCtrl::Create | ( | wxWindow * | parent, | |
wxWindowID | id, | |||
const wxDateTime & | dt = wxDefaultDateTime , |
|||
const wxPoint & | pos = wxDefaultPosition , |
|||
const wxSize & | size = wxDefaultSize , |
|||
long | style = wxDP_DEFAULT|wxDP_SHOWCENTURY , |
|||
const wxValidator & | validator = wxDefaultValidator , |
|||
const wxString & | name = "datectrl" | |||
) |
parent | Parent window, must not be non-NULL. | |
id | The identifier for the control. | |
dt | The initial value of the control, if an invalid date (such as the default value) is used, the control is set to today. | |
pos | Initial position. | |
size | Initial size. If left at default value, the control chooses its own best size by using the height approximately equal to a text control and width large enough to show the date string fully. | |
style | The window style, should be left at 0 as there are no special styles for this control in this version. | |
validator | Validator which can be used for additional date checks. | |
name | Control name. |
virtual bool wxDatePickerCtrl::GetRange | ( | wxDateTime * | dt1, | |
wxDateTime * | dt2 | |||
) | const [pure virtual] |
If the control had been previously limited to a range of dates using SetRange(), returns the lower and upper bounds of this range.
If no range is set (or only one of the bounds is set), dt1 and/or dt2 are set to be invalid.
dt1 | Pointer to the object which receives the lower range limit or becomes invalid if it is not set. May be NULL if the caller is not interested in lower limit. | |
dt2 | Same as above but for the upper limit. |
virtual wxDateTime wxDatePickerCtrl::GetValue | ( | ) | const [pure virtual] |
Returns the currently selected.
If there is no selection or the selection is outside of the current range, an invalid object is returned.
virtual void wxDatePickerCtrl::SetRange | ( | const wxDateTime & | dt1, | |
const wxDateTime & | dt2 | |||
) | [pure virtual] |
Sets the valid range for the date selection.
If dt1 is valid, it becomes the earliest date (inclusive) accepted by the control. If dt2 is valid, it becomes the latest possible date.
virtual void wxDatePickerCtrl::SetValue | ( | const wxDateTime & | dt | ) | [pure virtual] |
Changes the current value of the control.
The date should be valid unless the control was created with wxDP_ALLOWNONE
style and included in the currently selected range, if any.
Calling this method does not result in a date change event.
![]() |
[ top ] |