Install Now
QwtCounter - The Counter Widget.
Contents
Constructor & Destructor Documentation
QwtCounter::QwtCounter(QWidget*parent=NULL)[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:
• Button 1: 1 step
• Button 2: 10 steps
• Button 3: 100 steps
Parameters:parentDetailed Description
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:
#include <qwt_counter.h>
QwtCounter *counter = new QwtCounter(parent);
counter->setRange(0.0, 100.0); // From 0.0 to 100
counter->setSingleStep( 1.0 ); // Step size 1.0
counter->setNumButtons(2); // Two buttons each side
counter->setIncSteps(QwtCounter::Button1, 1); // Button 1 increments 1 step
counter->setIncSteps(QwtCounter::Button2, 20); // Button 2 increments 20 steps
connect(counter, SIGNAL(valueChanged(double)), myClass, SLOT(newValue(double)));
Member Enumeration Documentation
enumQwtCounter::Button
Button index.
EnumeratorButton1
Button intended for minor steps.
Button2
Button intended for medium steps.
Button3
Button intended for large steps.
ButtonCnt
Number of buttons.
Member Function Documentation
voidQwtCounter::buttonReleased(doublevalue)[signal]
This signal is emitted when a button has been released
Parameters:value The new value
boolQwtCounter::event(QEvent*event)[protected],[virtual]
Handle QEvent::PolishRequest events
Parameters:event Event
Returns:
see QWidget::event()
intQwtCounter::incSteps(QwtCounter::Buttonbutton)constReturns:
The number of steps by which a specified button increments the value or 0 if the button is invalid.
Parameters:button Button index
Seealso:setIncSteps()boolQwtCounter::isReadOnly()constReturns:
True, when the line line edit is read only. (default is no)
Seealso:setReadOnly()boolQwtCounter::isValid()constReturns:
True, if the value is valid
Seealso:setValid(), setValue()voidQwtCounter::keyPressEvent(QKeyEvent*event)[protected],[virtual]
Handle key events
• Ctrl + Qt::Key_Home
Step to minimum()
• Ctrl + Qt::Key_End
Step to maximum()
• Qt::Key_Up
Increment by incSteps(QwtCounter::Button1)
• Qt::Key_Down
Decrement by incSteps(QwtCounter::Button1)
• Qt::Key_PageUp
Increment by incSteps(QwtCounter::Button2)
• Qt::Key_PageDown
Decrement by incSteps(QwtCounter::Button2)
• Shift + Qt::Key_PageUp
Increment by incSteps(QwtCounter::Button3)
• Shift + Qt::Key_PageDown
Decrement by incSteps(QwtCounter::Button3)
Parameters:event Key event
doubleQwtCounter::maximum()constReturns:
The maximum of the range
Seealso:setRange(), setMaximum(), minimum()doubleQwtCounter::minimum()constReturns:
The minimum of the range
Seealso:setRange(), setMinimum(), maximum()intQwtCounter::numButtons()constReturns:
The number of buttons on each side of the widget.
Seealso:setNumButtons()voidQwtCounter::setIncSteps(QwtCounter::Buttonbutton,intnumSteps)
Specify the number of steps by which the value is incremented or decremented when a specified button is
pushed.
Parameters:button Button index
numSteps Number of steps
Seealso:incSteps()voidQwtCounter::setMaximum(doublevalue)
Set the maximum value of the range
Parameters:value Maximum value
Seealso:setRange(), setMinimum(), maximum()voidQwtCounter::setMinimum(doublevalue)
Set the minimum value of the range
Parameters:value Minimum value
Seealso:setRange(), setMaximum(), minimum()Note:
The maximum is adjusted if necessary to ensure that the range remains valid.
voidQwtCounter::setNumButtons(intnumButtons)
Specify the number of buttons on each side of the label
Parameters:numButtons Number of buttons
Seealso:numButtons()voidQwtCounter::setRange(doublemin,doublemax)
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.
Parameters:min Minimum value
max Maximum value
Seealso:minimum(), maximum()voidQwtCounter::setReadOnly(boolon)
Allow/disallow the user to manually edit the value.
Parameters:on True disable editing
Seealso:isReadOnly()voidQwtCounter::setSingleStep(doublestepSize)
Set the step size of the counter. A value <= 0.0 disables stepping
Parameters:stepSize Single step size
Seealso:singleStep()voidQwtCounter::setStepButton1(intnSteps)
Set the number of increment steps for button 1
Parameters:nSteps Number of steps
voidQwtCounter::setStepButton2(intnSteps)
Set the number of increment steps for button 2
Parameters:nSteps Number of steps
voidQwtCounter::setStepButton3(intnSteps)
Set the number of increment steps for button 3
Parameters:nSteps Number of steps
voidQwtCounter::setValid(boolon)
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.
Parameters:on If true the counter will be set as valid
Seealso:setValue(), isValid()voidQwtCounter::setValue(doublevalue)[slot]
Set a new value without adjusting to the step raster. The state of the counter is set to be valid.
Parameters:value New value
Seealso:isValid(), value(), valueChanged()Warning:
The value is clipped when it lies outside the range.
voidQwtCounter::setWrapping(boolon)
En/Disable wrapping. If wrapping is true stepping up from maximum() value will take you to the minimum()
value and vice versa.
Parameters:on En/Disable wrapping
Seealso:wrapping()doubleQwtCounter::singleStep()constReturns:
Single step size
Seealso:setSingleStep()doubleQwtCounter::value()constReturns:
Current value of the counter
Seealso:setValue(), valueChanged()voidQwtCounter::valueChanged(doublevalue)[signal]
This signal is emitted when the counter's value has changed
Parameters:value The new value
voidQwtCounter::wheelEvent(QWheelEvent*event)[protected],[virtual]
Handle wheel events
Parameters:event Wheel event
boolQwtCounter::wrapping()constReturns:
True, when wrapping is set
Seealso:setWrapping()Name
QwtCounter - The Counter Widget.
Synopsis
#include <qwt_counter.h>
Inherits QWidget.
PublicTypes
enum Button { Button1, Button2, Button3, ButtonCnt }
Button index.
PublicSlots
void setValue (double)
Set a new value without adjusting to the step raster.
Signals
void buttonReleased (double value)
void valueChanged (double value)
PublicMemberFunctionsQwtCounter (QWidget *parent=NULL)
virtual ~QwtCounter ()
Destructor.
void setValid (bool)
bool isValid () const
void setWrapping (bool)
En/Disable wrapping.
bool wrapping () const
bool isReadOnly () const
void setReadOnly (bool)
Allow/disallow the user to manually edit the value.
void setNumButtons (int)
int numButtons () const
void setIncSteps (QwtCounter::Button, int numSteps)
int incSteps (QwtCounter::Button) const
virtual QSize sizeHint () const
A size hint.
double singleStep () const
void setSingleStep (double stepSize)
Set the step size of the counter.
void setRange (double min, double max)
Set the minimum and maximum values.
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
ProtectedMemberFunctions
virtual bool event (QEvent *)
virtual void wheelEvent (QWheelEvent *)
virtual void keyPressEvent (QKeyEvent *)
PNG Icons
