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.
- atom parent
- integer id [=-1]
- sequence date_time [=wxDefaultDateTime]
- integer x [=-1]
- integer y [=-1]
- integer cx [=-1]
- integer cy [=-1]
- integer style [=wxCLRP_DEFAULT_STYLE]
- wxDP_SPIN Creates a control without a month calendar drop down but with spin-control-like arrows to change individual date components. This style is not supported by the generic version.
- wxDP_DROPDOWN Creates a control with a month calendar drop-down part from which the user can select a date.
- wxDP_DEFAULT Creates a control with the style that is best supported for the current platform (currently wxDP_SPIN under Windows and wxDP_DROPDOWN elsewhere).
- wxDP_ALLOWNONE With this style, the control allows the user to not enter any valid date at all. Without it - the default - the control always has some valid date.
- wxDP_SHOWCENTURY Forces display of the century in the default date format. Without this style the century could be displayed, or not, depending on the default date representation in the system.
You can use the wxEVT_DATE_CHANGED event along with get_dateevent_date.
Returns the currently selected date. If there is no selection or the selection
is outside of the current range, an invalid object is returned.
If the control had been previously limited to a range of dates using
set_picker_range , returns the lower and upper bounds of this range. If no
range is set (or only one of the bounds is set), returns 0.
Changes the current value of the control. The date should be valid and included in the currently selected range, if any.
Calling this method does not result in a date change event.
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.
If the current value of the control is outside of the newly set range bounds, the behaviour is undefined.