|
Qwt User's Guide
6.2.0
|
The Counter Widget. More...
#include <qwt_counter.h>
Public Types | |
| enum | Button { Button1 , Button2 , Button3 , ButtonCnt } |
| Button index. More... | |
Public Slots | |
| void | setValue (double) |
| Set a new value without adjusting to the step raster. More... | |
Signals | |
| void | buttonReleased (double value) |
| void | valueChanged (double value) |
Public Member Functions | |
| QwtCounter (QWidget *parent=NULL) | |
| virtual | ~QwtCounter () |
| Destructor. | |
| void | setValid (bool) |
| bool | isValid () const |
| void | setWrapping (bool) |
| En/Disable wrapping. More... | |
| bool | wrapping () const |
| bool | isReadOnly () const |
| void | setReadOnly (bool) |
| Allow/disallow the user to manually edit the value. More... | |
| void | setNumButtons (int) |
| int | numButtons () const |
| void | setIncSteps (QwtCounter::Button, int numSteps) |
| int | incSteps (QwtCounter::Button) const |
| virtual QSize | sizeHint () const override |
| A size hint. | |
| double | singleStep () const |
| void | setSingleStep (double stepSize) |
| Set the step size of the counter. More... | |
| void | setRange (double min, double max) |
| Set the minimum and maximum values. More... | |
| double | minimum () const |
| void | setMinimum (double) |
| double | maximum () const |
| void | setMaximum (double) |
| void | setStepButton1 (int nSteps) |
| int | stepButton1 () const |
| returns the number of increment steps for button 1 | |
| void | setStepButton2 (int nSteps) |
| int | stepButton2 () const |
| returns the number of increment steps for button 2 | |
| void | setStepButton3 (int nSteps) |
| int | stepButton3 () const |
| returns the number of increment steps for button 3 | |
| double | value () const |
Protected Member Functions | |
| virtual bool | event (QEvent *) override |
| virtual void | wheelEvent (QWheelEvent *) override |
| virtual void | keyPressEvent (QKeyEvent *) override |
The Counter Widget.
A Counter consists of a label displaying a number and one ore more (up to three) push buttons on each side of the label which can be used to increment or decrement the counter's value.
A counter has a range from a minimum value to a maximum value and a step size. When the wrapping property is set the counter is circular.
The number of steps by which a button increments or decrements the value can be specified using setIncSteps(). The number of buttons can be changed with setNumButtons().
Example:
Definition at line 48 of file qwt_counter.h.
| enum QwtCounter::Button |
Button index.
| Enumerator | |
|---|---|
| Button1 | Button intended for minor steps. |
| Button2 | Button intended for medium steps. |
| Button3 | Button intended for large steps. |
| ButtonCnt | Number of buttons. |
Definition at line 67 of file qwt_counter.h.
|
explicit |
The counter is initialized with a range is set to [0.0, 1.0] with 0.01 as single step size. The value is invalid.
The default number of buttons is set to 2. The default increments are:
| parent |
Definition at line 65 of file qwt_counter.cpp.
|
signal |
This signal is emitted when a button has been released
| value | The new value |
|
overrideprotectedvirtual |
Handle QEvent::PolishRequest events
| event | Event |
Definition at line 485 of file qwt_counter.cpp.
| int QwtCounter::incSteps | ( | QwtCounter::Button | button | ) | const |
| button | Button index |
Definition at line 416 of file qwt_counter.cpp.
| bool QwtCounter::isReadOnly | ( | ) | const |
Definition at line 186 of file qwt_counter.cpp.
| bool QwtCounter::isValid | ( | ) | const |
Definition at line 166 of file qwt_counter.cpp.
|
overrideprotectedvirtual |
Handle key events
| event | Key event |
Definition at line 524 of file qwt_counter.cpp.
| double QwtCounter::maximum | ( | ) | const |
Definition at line 306 of file qwt_counter.cpp.
| double QwtCounter::minimum | ( | ) | const |
Definition at line 286 of file qwt_counter.cpp.
| int QwtCounter::numButtons | ( | ) | const |
Definition at line 388 of file qwt_counter.cpp.
| void QwtCounter::setIncSteps | ( | QwtCounter::Button | button, |
| int | numSteps | ||
| ) |
Specify the number of steps by which the value is incremented or decremented when a specified button is pushed.
| button | Button index |
| numSteps | Number of steps |
Definition at line 403 of file qwt_counter.cpp.
| void QwtCounter::setMaximum | ( | double | value | ) |
Set the maximum value of the range
| value | Maximum value |
Definition at line 297 of file qwt_counter.cpp.
| void QwtCounter::setMinimum | ( | double | value | ) |
Set the minimum value of the range
| value | Minimum value |
Definition at line 277 of file qwt_counter.cpp.
| void QwtCounter::setNumButtons | ( | int | numButtons | ) |
Specify the number of buttons on each side of the label
| numButtons | Number of buttons |
Definition at line 362 of file qwt_counter.cpp.
| void QwtCounter::setRange | ( | double | min, |
| double | max | ||
| ) |
Set the minimum and maximum values.
The maximum is adjusted if necessary to ensure that the range remains valid. The value might be modified to be inside of the range.
| min | Minimum value |
| max | Maximum value |
Definition at line 241 of file qwt_counter.cpp.
| void QwtCounter::setReadOnly | ( | bool | on | ) |
Allow/disallow the user to manually edit the value.
| on | True disable editing |
Definition at line 177 of file qwt_counter.cpp.
| void QwtCounter::setSingleStep | ( | double | stepSize | ) |
Set the step size of the counter.
A value <= 0.0 disables stepping
| stepSize | Single step size |
Definition at line 319 of file qwt_counter.cpp.
| void QwtCounter::setStepButton1 | ( | int | nSteps | ) |
Set the number of increment steps for button 1
| nSteps | Number of steps |
Definition at line 429 of file qwt_counter.cpp.
| void QwtCounter::setStepButton2 | ( | int | nSteps | ) |
Set the number of increment steps for button 2
| nSteps | Number of steps |
Definition at line 444 of file qwt_counter.cpp.
| void QwtCounter::setStepButton3 | ( | int | nSteps | ) |
Set the number of increment steps for button 3
| nSteps | Number of steps |
Definition at line 459 of file qwt_counter.cpp.
| void QwtCounter::setValid | ( | bool | on | ) |
Set the counter to be in valid/invalid state
When the counter is set to invalid, no numbers are displayed and the buttons are disabled.
| on | If true the counter will be set as valid |
Definition at line 142 of file qwt_counter.cpp.
|
slot |
Set a new value without adjusting to the step raster.
The state of the counter is set to be valid.
| value | New value |
Definition at line 202 of file qwt_counter.cpp.
| void QwtCounter::setWrapping | ( | bool | on | ) |
En/Disable wrapping.
If wrapping is true stepping up from maximum() value will take you to the minimum() value and vice versa.
| on | En/Disable wrapping |
Definition at line 342 of file qwt_counter.cpp.
| double QwtCounter::singleStep | ( | ) | const |
| double QwtCounter::value | ( | ) | const |
Definition at line 225 of file qwt_counter.cpp.
|
signal |
This signal is emitted when the counter's value has changed
| value | The new value |
|
overrideprotectedvirtual |
| bool QwtCounter::wrapping | ( | ) | const |
Definition at line 351 of file qwt_counter.cpp.