// Purpose: interface of wxDatePickerCtrl
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
const wxString& name = "datectrl");
/**
+ Create the control window.
+
+ This method should only be used for objects created using default
+ constructor.
+
@param parent
Parent window, must not be non-@NULL.
@param id
best size by using the height approximately equal to a text control
and width large enough to show the date string fully.
@param style
- The window style, should be left at 0 as there are no special
- styles for this control in this version.
+ The window style, see the description of the styles in the class
+ documentation.
@param validator
Validator which can be used for additional date checks.
@param name
range is set (or only one of the bounds is set), @a dt1 and/or @a dt2
are set to be invalid.
+ Notice that when using a native MSW implementation of this control the
+ lower range is always set, even if SetRange() hadn't been called
+ explicitly, as the native control only supports dates later than year
+ 1601.
+
@param 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
virtual bool GetRange(wxDateTime* dt1, wxDateTime* dt2) const = 0;
/**
- Returns the currently selected. If there is no selection or the
- selection is outside of the current range, an invalid object is
- returned.
- */
- virtual wxDateTime GetValue() const = 0;
+ Returns the currently entered date.
- /**
- Sets the display format for the date in the control. See wxDateTime for
- the meaning of format strings.
-
- @note This function is only available in the generic version of this
- control. The native version always uses the current system locale.
-
- @remarks If the format parameter is invalid, the behaviour is undefined.
+ For a control with @c wxDP_ALLOWNONE style the returned value may be
+ invalid if no date is entered, otherwise it is always valid.
*/
- bool SetFormat(const wxString& format);
+ virtual wxDateTime GetValue() const = 0;
/**
Sets the valid range for the date selection. If @a dt1 is valid, it