]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/datectrl.tex
changed wxWindow::Refresh() to refresh the window children as well (as wxGTK already...
[wxWidgets.git] / docs / latex / wx / datectrl.tex
index cda0fa313846ba9bea3918ef1837e4988f5b486a..19eb95a49b837502abf5548febfa1b545d7da8df 100644 (file)
@@ -5,17 +5,19 @@
 %% Created:     2005-01-15
 %% RCS-ID:      $Id$
 %% Copyright:   (c) 2005 Vadim Zeitlin
-%% License:     wxWidgets license
+%% License:     wxWindows license
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \section{\class{wxDatePickerCtrl}}\label{wxdatepickerctrl}
 
-This control allows the user to select a date. Unlike
+This control allows the user to select a date. Unlike 
 \helpref{wxCalendarCtrl}{wxcalendarctrl}, which is a relatively big control,
-it is implemented as a small window showing the currently selected date and
-allowing to edit it directly using the keyboard and may also display a popup
+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.
+the platform, except PalmOS where date is selected using native dialog.
+
+It is only available if \texttt{wxUSE\_DATEPICKCTRL} is set to $1$.
 
 \wxheading{Derived from}
 
@@ -26,7 +28,7 @@ the platform.
 
 \wxheading{Include files}
 
-<wx/dateevt.h>
+<wx/datectrl.h>
 
 (only available if \texttt{wxUSE\_DATEPICKCTRL} is set to $1$)
 
@@ -42,6 +44,12 @@ calendar drop down part from which the user can select a date.}
 \twocolitem{\windowstyle{wxDP\_DEFAULT}}{Creates a control with default style
 which is the best supported for the current platform (currently wxDP\_SPIN
 under Windows and wxDP\_DROPDOWN elsewhere).}
+\twocolitem{\windowstyle{wxDP\_ALLOWNONE}}{With this style, the control allows
+the user to not enter any valid date at all. Without it -- which is by default
+-- the control always has some valid date.}
+\twocolitem{\windowstyle{wxDP\_SHOWCENTURY}}{Forces display of the century in
+the default date format. Without this flas the century could be displayed or
+not depending on the default date representation in the system.}
 \end{twocollist}
 
 \wxheading{Event handling}
@@ -67,7 +75,7 @@ changes the current selection in the control.}
 \param{const wxDateTime\& }{dt = wxDefaultDateTime},\rtfsp
 \param{const wxPoint\& }{pos = wxDefaultPosition},\rtfsp
 \param{const wxSize\& }{size = wxDefaultSize},\rtfsp
-\param{long}{ style = wxDP\_DEFAULT},\rtfsp
+\param{long}{ style = wxDP\_DEFAULT | wxDP\_SHOWCENTURY},\rtfsp
 \param{const wxValidator\& }{validator = wxDefaultValidator},
 \param{const wxString\& }{name = ``datectrl"}}
 
@@ -82,7 +90,7 @@ all the parameters.
 \param{const wxDateTime\& }{dt = wxDefaultDateTime},\rtfsp
 \param{const wxPoint\& }{pos = wxDefaultPosition},\rtfsp
 \param{const wxSize\& }{size = wxDefaultSize},\rtfsp
-\param{long}{ style = wxDP\_DEFAULT},\rtfsp
+\param{long}{ style = wxDP\_DEFAULT | wxDP\_SHOWCENTURY},\rtfsp
 \param{const wxValidator\& }{validator = wxDefaultValidator},
 \param{const wxString\& }{name = ``datectrl"}}
 
@@ -167,4 +175,3 @@ in the currently selected range, if any.
 
 Calling this method does not result in a date change event.
 
-