// Name: datectrl.h
// Purpose: interface of wxDatePickerCtrl
// Author: wxWidgets team
-// RCS-ID: $Id$
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
+/// wxDatePickerCtrl styles
+enum
+{
+ /// default style on this platform, either wxDP_SPIN or wxDP_DROPDOWN
+ wxDP_DEFAULT = 0,
+
+ /// a spin control-like date picker (not supported in generic version)
+ wxDP_SPIN = 1,
+
+ /// a combobox-like date picker (not supported in mac version)
+ wxDP_DROPDOWN = 2,
+
+ /// always show century in the default date display (otherwise it depends on
+ /// the system date format which may include the century or not)
+ wxDP_SHOWCENTURY = 4,
+
+ /// allow not having any valid date in the control (by default it always has
+ /// some date, today initially if no valid date specified in ctor)
+ wxDP_ALLOWNONE = 8
+};
+
+
/**
@class wxDatePickerCtrl
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.
+ date selection, depending on the styles used and the platform.
It is only available if @c wxUSE_DATEPICKCTRL is set to 1.
@library{wxadv}
@category{pickers}
- @appearance{datepickerctrl.png}
+ @appearance{datepickerctrl}
@see wxCalendarCtrl, wxDateEvent
*/
class wxDatePickerCtrl : public wxControl
{
public:
+ /**
+ Default constructor.
+ */
+ wxDatePickerCtrl();
+
/**
Initializes the object and calls Create() with all the parameters.
*/
@return @false if no range limits are currently set, @true if at least
one bound is set.
*/
- virtual bool GetRange(wxDateTime* dt1, wxDateTime* dt2) const = 0;
+ virtual bool GetRange(wxDateTime* dt1, wxDateTime* dt2) const;
/**
Returns the currently entered date.
For a control with @c wxDP_ALLOWNONE style the returned value may be
invalid if no date is entered, otherwise it is always valid.
*/
- virtual wxDateTime GetValue() const = 0;
+ virtual wxDateTime GetValue() const;
/**
Sets the valid range for the date selection. If @a dt1 is valid, it
@remarks If the current value of the control is outside of the newly
set range bounds, the behaviour is undefined.
*/
- virtual void SetRange(const wxDateTime& dt1, const wxDateTime& dt2) = 0;
+ virtual void SetRange(const wxDateTime& dt1, const wxDateTime& dt2);
/**
Changes the current value of the control.
Calling this method does not result in a date change event.
*/
- virtual void SetValue(const wxDateTime& dt) = 0;
+ virtual void SetValue(const wxDateTime& dt);
};