]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/spinctrl.tex
Always draw the selection of selected items, not just when they have
[wxWidgets.git] / docs / latex / wx / spinctrl.tex
index 44570693f64f3f65c314aa8743107281ca8a43c7..f6aacc08bd32b1cd03d7131499d07760440a967b 100644 (file)
@@ -23,20 +23,32 @@ wxSpinCtrl combines \helpref{wxTextCtrl}{wxtextctrl} and
 
 \twocolwidtha{5cm}
 \begin{twocollist}\itemsep=0pt
-\twocolitem{\windowstyle{wxSP\_ARROW\_KEYS}}{The user can use arrow keys.}
+\twocolitem{\windowstyle{wxSP\_ARROW\_KEYS}}{The user can use arrow keys to change the value.}
 \twocolitem{\windowstyle{wxSP\_WRAP}}{The value wraps at the minimum and maximum.}
 \end{twocollist}
 
 \wxheading{Event handling}
 
 To process input from a spin button, use one of these event handler macros to direct input to member
-functions that take a \helpref{wxScrollEvent}{wxscrollevent} argument:
+functions that take a \helpref{wxSpinEvent}{wxspinevent} argument:
 
 \twocolwidtha{7cm}
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf EVT\_SPINCTRL(id, func)}}{Generated whenever spinctrl is updated}
+\twocolitem{{\bf EVT\_SPINCTRL(id, func)}}{Generated whenever the numeric value
+of the spinctrl is updated}
 \end{twocollist}%
 
+You may also use the \helpref{wxSpinButton}{wxspinbutton} event macros, however
+the corresponding events will not be generated under all platforms. Finally, if
+the user modifies the text in the edit part of the spin control directly, the
+{\tt EVT\_TEXT} is generated, like for the \helpref{wxTextCtrl}{wxtextctrl}.
+
+When the use enters text into the text area, the text is not
+validated until the control loses focus (e.g. by using the TAB
+key). The value is then adjusted to the range and a 
+\helpref{wxSpinEvent}{wxspinevent} sent then if the value
+is different from the last value sent.
+
 \wxheading{See also}
 
 \helpref{Event handling overview}{eventhandlingoverview},
@@ -109,6 +121,17 @@ Gets the value of the spin control.
 
 Sets range of allowable values.
 
+\membersection{wxSpinCtrl::SetSelection}\label{wxspinctrlsetselection}
+
+\func{void}{SetSelection}{\param{long }{from}, \param{long }{to}}
+
+Select the text in the text part of the control between  positions 
+{\it from} (inclusive) and {\it to} (exclusive). This is similar to 
+\helpref{wxTextCtrl::SetSelection}{wxtextctrlsetselection}.
+
+{\bf NB:} this is currently only implemented for Windows and generic versions
+of the control.
+
 \membersection{wxSpinCtrl::GetMin}\label{wxspinctrlgetmin}
 
 \constfunc{int}{GetMin}{\void}