X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/684eee12d8c287cb10bf44fa4b420f461b345d5e..96461cc29d03b4a7ab72abaae2e7edace93dd2a5:/docs/latex/wx/datectrl.tex diff --git a/docs/latex/wx/datectrl.tex b/docs/latex/wx/datectrl.tex index 52d923a1ec..19eb95a49b 100644 --- a/docs/latex/wx/datectrl.tex +++ b/docs/latex/wx/datectrl.tex @@ -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,10 +28,30 @@ the platform. \wxheading{Include files} - + (only available if \texttt{wxUSE\_DATEPICKCTRL} is set to $1$) +\wxheading{Window styles} + +\twocolwidtha{5cm}% +\begin{twocollist}\itemsep=0pt +\twocolitem{\windowstyle{wxDP\_SPIN}}{Creates a control without month calendar +drop down but with spin control-like arrows to change individual date +components. This style is not supported by the generic version.} +\twocolitem{\windowstyle{wxDP\_DROPDOWN}}{Creates a control with a month +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} \twocolwidtha{7cm}% @@ -53,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 = 0},\rtfsp +\param{long}{ style = wxDP\_DEFAULT | wxDP\_SHOWCENTURY},\rtfsp \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``datectrl"}} @@ -68,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 = 0},\rtfsp +\param{long}{ style = wxDP\_DEFAULT | wxDP\_SHOWCENTURY},\rtfsp \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``datectrl"}} @@ -153,4 +175,3 @@ in the currently selected range, if any. Calling this method does not result in a date change event. -