995c6e6df5
SetIncrement() was already available in wxSpinCtrlDouble and GTK version of wxSpinCtrl, now implement support for it in wxMSW and wxOSX as well. In fact, in wxMSW, implement it at wxSpinButton level, so that both this class and wxSpinCtrl inheriting from it (in wxMSW only) support setting custom increment now. Also add support for it to XRC, show it in the sample and add a unit test verifying that it works. Closes #2597.
468 lines
15 KiB
Objective-C
468 lines
15 KiB
Objective-C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: spinctrl.h
|
|
// Purpose: interface of wxSpinCtrl
|
|
// Author: wxWidgets team
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
@class wxSpinCtrl
|
|
|
|
wxSpinCtrl combines wxTextCtrl and wxSpinButton in one control.
|
|
|
|
@beginStyleTable
|
|
@style{wxSP_ARROW_KEYS}
|
|
The user can use arrow keys to change the value.
|
|
@style{wxSP_WRAP}
|
|
The value wraps at the minimum and maximum.
|
|
@style{wxTE_PROCESS_ENTER}
|
|
Indicates that the control should generate @c wxEVT_TEXT_ENTER
|
|
events. Using this style will prevent the user from using the Enter key
|
|
for dialog navigation (e.g. activating the default button in the
|
|
dialog) under MSW.
|
|
@style{wxALIGN_LEFT}
|
|
Same as wxTE_LEFT for wxTextCtrl: the text is left aligned (this is the
|
|
default).
|
|
@style{wxALIGN_CENTRE_HORIZONTAL}
|
|
Same as wxTE_CENTRE for wxTextCtrl: the text is centered.
|
|
@style{wxALIGN_RIGHT}
|
|
Same as wxTE_RIGHT for wxTextCtrl: the text is right aligned.
|
|
@endStyleTable
|
|
|
|
|
|
@beginEventEmissionTable{wxSpinEvent}
|
|
@event{EVT_SPINCTRL(id, func)}
|
|
Process a wxEVT_SPINCTRL event, which is generated
|
|
whenever the numeric value of the spin control is updated.
|
|
@endEventTable
|
|
|
|
You may also use the 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 EVT_TEXT is generated,
|
|
like for the 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 wxSpinEvent sent then if the value
|
|
is different from the last value sent.
|
|
|
|
@library{wxcore}
|
|
@category{ctrl}
|
|
@appearance{spinctrl}
|
|
|
|
@see wxSpinButton, wxSpinCtrlDouble, wxControl
|
|
*/
|
|
class wxSpinCtrl : public wxControl
|
|
{
|
|
public:
|
|
/**
|
|
Default constructor.
|
|
*/
|
|
wxSpinCtrl();
|
|
|
|
/**
|
|
Constructor, creating and showing a spin control.
|
|
|
|
If @a value is non-empty, it will be shown in the text entry part of
|
|
the control and if it has numeric value, the initial numeric value of
|
|
the control, as returned by GetValue() will also be determined by it
|
|
instead of by @a initial. Hence, it only makes sense to specify @a
|
|
initial if @a value is an empty string or is not convertible to a
|
|
number, otherwise @a initial is simply ignored and the number specified
|
|
by @a value is used.
|
|
|
|
@param parent
|
|
Parent window. Must not be @NULL.
|
|
@param value
|
|
Default value (as text).
|
|
@param id
|
|
Window identifier. The value wxID_ANY indicates a default value.
|
|
@param pos
|
|
Window position.
|
|
If ::wxDefaultPosition is specified then a default position is chosen.
|
|
@param size
|
|
Window size.
|
|
If ::wxDefaultSize is specified then a default size is chosen.
|
|
@param style
|
|
Window style. See wxSpinButton.
|
|
@param min
|
|
Minimal value.
|
|
@param max
|
|
Maximal value.
|
|
@param initial
|
|
Initial value.
|
|
@param name
|
|
Window name.
|
|
|
|
@see Create()
|
|
*/
|
|
wxSpinCtrl(wxWindow* parent, wxWindowID id = wxID_ANY,
|
|
const wxString& value = wxEmptyString,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxSP_ARROW_KEYS,
|
|
int min = 0, int max = 100,
|
|
int initial = 0, const wxString& name = "wxSpinCtrl");
|
|
|
|
/**
|
|
Creation function called by the spin control constructor.
|
|
See wxSpinCtrl() for details.
|
|
*/
|
|
bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
|
|
const wxString& value = wxEmptyString,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxSP_ARROW_KEYS,
|
|
int min = 0, int max = 100,
|
|
int initial = 0, const wxString& name = "wxSpinCtrl");
|
|
|
|
/**
|
|
Returns the numerical base being currently used, 10 by default.
|
|
|
|
@see SetBase()
|
|
|
|
@since 2.9.5
|
|
*/
|
|
int GetBase() const;
|
|
|
|
/**
|
|
Gets maximal allowable value.
|
|
*/
|
|
int GetMax() const;
|
|
|
|
/**
|
|
Gets minimal allowable value.
|
|
*/
|
|
int GetMin() const;
|
|
|
|
/**
|
|
Returns the text in the text entry part of the control.
|
|
|
|
@since 3.1.6
|
|
*/
|
|
wxString GetTextValue() const;
|
|
|
|
/**
|
|
Gets the value of the spin control.
|
|
*/
|
|
int GetValue() const;
|
|
|
|
/**
|
|
Get the value for increment for a spin control.
|
|
|
|
The default value is 1 but it can be changed using SetIncrement().
|
|
|
|
@since 3.1.6
|
|
*/
|
|
int GetIncrement() const;
|
|
|
|
/**
|
|
Sets the base to use for the numbers in this control.
|
|
|
|
Currently the only supported values are 10 (which is the default) and
|
|
16.
|
|
|
|
Changing the base allows the user to enter the numbers in the specified
|
|
base, e.g. with "0x" prefix for hexadecimal numbers, and also displays
|
|
the numbers in the specified base when they are changed using the spin
|
|
control arrows.
|
|
|
|
@note Setting a base to 16 is allowed only if current range does not
|
|
include negative values.
|
|
|
|
@param base
|
|
Numeric base, currently only 10 and 16 are supported.
|
|
@return
|
|
@true if the base was successfully changed or @false if it failed,
|
|
usually meaning that either the base is not 10 or 16 or that
|
|
the base is not supported for values in the current range.
|
|
|
|
@since 2.9.5
|
|
*/
|
|
bool SetBase(int base);
|
|
|
|
/**
|
|
Sets range of allowable values.
|
|
|
|
Notice that calling this method may change the value of the control if
|
|
it's not inside the new valid range, e.g. it will become @a minVal if
|
|
it is less than it now. However no @c wxEVT_SPINCTRL
|
|
event is generated, even if it the value does change.
|
|
|
|
@note Setting a range including negative values is silently ignored
|
|
if current base is set to 16.
|
|
*/
|
|
void SetRange(int minVal, int maxVal);
|
|
|
|
/**
|
|
Select the text in the text part of the control between positions
|
|
@a from (inclusive) and @a to (exclusive).
|
|
This is similar to wxTextCtrl::SetSelection().
|
|
|
|
@note this is currently only implemented for Windows and generic versions
|
|
of the control.
|
|
*/
|
|
virtual void SetSelection(long from, long to);
|
|
|
|
/**
|
|
Sets the value of the spin control.
|
|
|
|
It is recommended to use the overload taking an integer value instead.
|
|
If @a text doesn't represent a valid number, it may not be shown in the
|
|
text part of the control at all (only empty string is guaranteed to be
|
|
supported under all platforms) and the numeric value will be changed to
|
|
GetMin().
|
|
|
|
Notice that, unlike wxTextCtrl::SetValue(), but like most of the other
|
|
setter methods in wxWidgets, calling this method does not generate any
|
|
events as events are only generated for the user actions.
|
|
*/
|
|
virtual void SetValue(const wxString& text);
|
|
|
|
/**
|
|
Sets the value of the spin control.
|
|
|
|
Calling this method doesn't generate any @c wxEVT_SPINCTRL events.
|
|
*/
|
|
void SetValue(int value);
|
|
|
|
/**
|
|
Sets the increment for the control.
|
|
|
|
The increment is the number by which the value changes when the up or
|
|
down arrow is used.
|
|
|
|
The default is 1, but it can be useful to set it to a higher value when
|
|
using the control for bigger numbers.
|
|
|
|
Note that it is still possible to enter any value (in the valid range)
|
|
into the control manually, whatever is the value of the increment.
|
|
|
|
@since 3.1.6
|
|
*/
|
|
void SetIncrement(int value);
|
|
};
|
|
|
|
/**
|
|
@class wxSpinCtrlDouble
|
|
|
|
wxSpinCtrlDouble combines wxTextCtrl and wxSpinButton in one control and
|
|
displays a real number. (wxSpinCtrl displays an integer.)
|
|
|
|
@beginStyleTable
|
|
@style{wxSP_ARROW_KEYS}
|
|
The user can use arrow keys to change the value.
|
|
@style{wxSP_WRAP}
|
|
The value wraps at the minimum and maximum.
|
|
@endStyleTable
|
|
|
|
@beginEventEmissionTable{wxSpinDoubleEvent}
|
|
@event{EVT_SPINCTRLDOUBLE(id, func)}
|
|
Generated whenever the numeric value of the spin control is changed,
|
|
that is, when the up/down spin button is clicked, when ENTER is pressed,
|
|
or the control loses focus and the new value is different from the last.
|
|
See wxSpinDoubleEvent.
|
|
@endEventTable
|
|
|
|
@library{wxcore}
|
|
@category{ctrl}
|
|
@appearance{spinctrldouble}
|
|
|
|
@see wxSpinButton, wxSpinCtrl, wxControl
|
|
*/
|
|
class wxSpinCtrlDouble : public wxControl
|
|
{
|
|
public:
|
|
/**
|
|
Default constructor.
|
|
*/
|
|
wxSpinCtrlDouble();
|
|
|
|
/**
|
|
Constructor, creating and showing a spin control.
|
|
|
|
If @a value is non-empty, it will be shown in the text entry part of
|
|
the control and if it has numeric value, the initial numeric value of
|
|
the control, as returned by GetValue() will also be determined by it
|
|
instead of by @a initial. Hence, it only makes sense to specify @a
|
|
initial if @a value is an empty string or is not convertible to a
|
|
number, otherwise @a initial is simply ignored and the number specified
|
|
by @a value is used.
|
|
|
|
@param parent
|
|
Parent window. Must not be @NULL.
|
|
@param value
|
|
Default value (as text).
|
|
@param id
|
|
Window identifier. The value wxID_ANY indicates a default value.
|
|
@param pos
|
|
Window position.
|
|
If ::wxDefaultPosition is specified then a default position is chosen.
|
|
@param size
|
|
Window size.
|
|
If ::wxDefaultSize is specified then a default size is chosen.
|
|
@param style
|
|
Window style. See wxSpinButton.
|
|
@param min
|
|
Minimal value.
|
|
@param max
|
|
Maximal value.
|
|
@param initial
|
|
Initial value.
|
|
@param inc
|
|
Increment value.
|
|
@param name
|
|
Window name.
|
|
|
|
The precision (number of digits after the decimal point) of the value
|
|
of the spin control is derived from the precision of @a inc.
|
|
If necessary, default precision can be adjusted by call to SetDigits().
|
|
|
|
@see Create()
|
|
*/
|
|
wxSpinCtrlDouble(wxWindow* parent, wxWindowID id = -1,
|
|
const wxString& value = wxEmptyString,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxSP_ARROW_KEYS,
|
|
double min = 0, double max = 100,
|
|
double initial = 0, double inc = 1,
|
|
const wxString& name = wxT("wxSpinCtrlDouble"));
|
|
|
|
/**
|
|
Creation function called by the spin control constructor.
|
|
See wxSpinCtrlDouble() for details.
|
|
*/
|
|
bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
|
|
const wxString& value = wxEmptyString,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxSP_ARROW_KEYS, double min = 0, double max = 100,
|
|
double initial = 0, double inc = 1,
|
|
const wxString& name = "wxSpinCtrlDouble");
|
|
|
|
/**
|
|
Gets precision of the value of the spin control.
|
|
*/
|
|
unsigned int GetDigits() const;
|
|
|
|
/**
|
|
Gets the increment value.
|
|
*/
|
|
double GetIncrement() const;
|
|
|
|
/**
|
|
Gets maximal allowable value.
|
|
*/
|
|
double GetMax() const;
|
|
|
|
/**
|
|
Gets minimal allowable value.
|
|
*/
|
|
double GetMin() const;
|
|
|
|
/**
|
|
Returns the text in the text entry part of the control.
|
|
|
|
@since 3.1.6
|
|
*/
|
|
wxString GetTextValue() const;
|
|
|
|
/**
|
|
Gets the value of the spin control.
|
|
*/
|
|
double GetValue() const;
|
|
|
|
/**
|
|
Sets precision of the value of the spin control.
|
|
Up to 20 digits are allowed after the decimal point.
|
|
*/
|
|
void SetDigits(unsigned int digits);
|
|
|
|
/**
|
|
Sets the increment value.
|
|
|
|
Using this method changes the number of digits used by the control to
|
|
at least match the value of @a inc, e.g. using the increment of @c 0.01
|
|
sets the number of digits to 2 if it had been less than 2 before.
|
|
However it doesn't change the number of digits if it had been already
|
|
high enough.
|
|
|
|
In any case, you may call SetDigits() explicitly to override the
|
|
automatic determination of the number of digits.
|
|
*/
|
|
void SetIncrement(double inc);
|
|
|
|
/**
|
|
Sets range of allowable values.
|
|
*/
|
|
void SetRange(double minVal, double maxVal);
|
|
|
|
/**
|
|
Sets the value of the spin control.
|
|
|
|
It is recommended to use the overload taking a double value instead.
|
|
If @a text doesn't represent a valid number, it may not be shown in the
|
|
text part of the control at all (only empty string is guaranteed to be
|
|
supported under all platforms) and the numeric value will be changed to
|
|
GetMin().
|
|
|
|
Notice that, unlike wxTextCtrl::SetValue(), but like most of the other
|
|
setter methods in wxWidgets, calling this method does not generate any
|
|
events as events are only generated for the user actions.
|
|
*/
|
|
virtual void SetValue(const wxString& text);
|
|
|
|
/**
|
|
Sets the value of the spin control.
|
|
|
|
Calling this method doesn't generate any @c wxEVT_SPINCTRLDOUBLE events.
|
|
*/
|
|
void SetValue(double value);
|
|
};
|
|
|
|
/**
|
|
@class wxSpinDoubleEvent
|
|
|
|
This event class is used for the events generated by wxSpinCtrlDouble.
|
|
|
|
@beginEventTable{wxSpinDoubleEvent}
|
|
@event{EVT_SPINCTRLDOUBLE(id, func)}
|
|
Generated whenever the numeric value of the spin control is changed,
|
|
that is, when the up/down spin button is clicked or when the control
|
|
loses focus and the new value is different from the last one.
|
|
See wxSpinDoubleEvent.
|
|
@endEventTable
|
|
|
|
@library{wxcore}
|
|
@category{events}
|
|
|
|
@see wxSpinCtrlDouble
|
|
*/
|
|
class wxSpinDoubleEvent : public wxNotifyEvent
|
|
{
|
|
public:
|
|
/**
|
|
The constructor. Not normally used by the user code.
|
|
*/
|
|
wxSpinDoubleEvent(wxEventType commandType = wxEVT_NULL, int winid = 0,
|
|
double value = 0);
|
|
|
|
/**
|
|
The copy constructor.
|
|
*/
|
|
wxSpinDoubleEvent(const wxSpinDoubleEvent& event);
|
|
|
|
/**
|
|
Returns the value associated with this spin control event.
|
|
*/
|
|
double GetValue() const;
|
|
|
|
/**
|
|
Set the value associated with the event.
|
|
(Not normally used by user code.)
|
|
*/
|
|
void SetValue(double value);
|
|
};
|
|
|
|
wxEventType wxEVT_SPINCTRL;
|
|
wxEventType wxEVT_SPINCTRLDOUBLE;
|