Main Page | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | File Members | Related Pages

QwtCounter Class Reference

Inheritance diagram for QwtCounter:

QwtDblRange List of all members.

Detailed 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. The range can be specified using QwtDblRange::setRange(). The counter's value is an integer multiple of the step size. The number of steps by which a button increments or decrements the value can be specified using QwtCounter::setIncSteps(). The number of buttons can be changed with QwtCounter::setNumButtons().

Holding the space bar down with focus on a button is the fastest method to step through the counter values. When the counter underflows/overflows, the focus is set to the smallest up/down button and counting is disabled. Counting is re-enabled on a button release event (mouse or space bar).

Example:

#include "../include/qwt_counter.h>

QwtCounter *cnt;

cnt = new QwtCounter(parent, name);

cnt->setRange(0.0, 100.0, 1.0);             // From 0.0 to 100, step 1.0
cnt->setNumButtons(2);                      // Two buttons each side
cnt->setIncSteps(QwtCounter::Button1, 1);   // Button 1 increments 1 step
cnt->setIncSteps(QwtCounter::Button2, 20);  // Button 2 increments 20 steps

connect(cnt, SIGNAL(valueChanged(double)), my_class, SLOT(newValue(double)));


Public Types

enum  Button {
  Button1,
  Button2,
  Button3,
  ButtonCnt
}

Public Member Functions

 QwtCounter (QWidget *parent=0, const char *name=0)
double step () const
void setStep (double s)
double minVal () const
void setMinValue (double m)
double maxVal () const
void setMaxValue (double m)
void setStepButton1 (int nSteps)
int stepButton1 () const
void setStepButton2 (int nSteps)
int stepButton2 () const
void setStepButton3 (int nSteps)
int stepButton3 () const
virtual double value () const
void setNumButtons (int n)
int numButtons () const
void setIncSteps (QwtCounter::Button btn, int nSteps)
int incSteps (QwtCounter::Button btn) const
virtual void setValue (double)
virtual QSizePolicy sizePolicy () const
virtual QSize sizeHint () const
virtual bool eventFilter (QObject *, QEvent *)

Protected Member Functions

void buttonReleased (double value)
void valueChanged (double value)
virtual void rangeChange ()
virtual void fontChange (const QFont &f)


Member Enumeration Documentation

enum QwtCounter::Button
 

Button index


Constructor & Destructor Documentation

QwtCounter::QwtCounter QWidget *  parent = 0,
const char *  name = 0
 

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:
parent 
name Forwarded to QWidget's ctor.


Member Function Documentation

void QwtCounter::buttonReleased double  value  )  [protected]
 

This signal is emitted when a button has been released

Parameters:
value The new value

bool QwtCounter::eventFilter QObject *  ,
QEvent * 
[virtual]
 

Keep track of key press and release events.

void QwtCounter::fontChange const QFont &  f  )  [protected, virtual]
 

Notify change of font.

This function updates the fonts of all widgets contained in QwtCounter.

Parameters:
f new font

int QwtCounter::incSteps QwtCounter::Button  btn  )  const
 

Returns:
the number of steps by which a specified button increments the value or 0 if the button is invalid.
Parameters:
btn One of QwtCounter::Button1, QwtCounter::Button2, QwtCounter::Button3

double QwtCounter::maxVal  )  const
 

returns the maximum value of the range

double QwtCounter::minVal  )  const
 

returns the minimum value of the range

int QwtCounter::numButtons  )  const
 

Returns:
The number of buttons on each side of the widget.

void QwtCounter::rangeChange  )  [protected, virtual]
 

Notify change of range.

This function updates the enabled property of all buttons contained in QwtCounter.

Reimplemented from QwtDblRange.

void QwtCounter::setIncSteps QwtCounter::Button  btn,
int  nSteps
 

Specify the number of steps by which the value is incremented or decremented when a specified button is pushed.

Parameters:
btn One of QwtCounter::Button1, QwtCounter::Button2, QwtCounter::Button3
nSteps Number of steps

void QwtCounter::setMaxValue double  m  ) 
 

sets the maximum value of the range

void QwtCounter::setMinValue double  m  ) 
 

sets the minimum value of the range

void QwtCounter::setNumButtons int  n  ) 
 

Specify the number of buttons on each side of the label.

Parameters:
n Number of buttons

void QwtCounter::setStep double  s  ) 
 

sets the step size

Reimplemented from QwtDblRange.

void QwtCounter::setStepButton1 int  nSteps  ) 
 

set the number of increment steps for button 1

void QwtCounter::setStepButton2 int  nSteps  ) 
 

set the number of increment steps for button 2

void QwtCounter::setStepButton3 int  nSteps  ) 
 

set the number of increment steps for button 3

void QwtCounter::setValue double  v  )  [virtual]
 

Set a new value.

Parameters:
v new value Calls QwtDblRange::setValue and does all visual updates.
See also:
QwtDblRange::setValue

Reimplemented from QwtDblRange.

QSize QwtCounter::sizeHint  )  const [virtual]
 

A size hint.

QSizePolicy QwtCounter::sizePolicy  )  const [virtual]
 

Preferred/Fixed.

double QwtCounter::step  )  const
 

returns the step size

Reimplemented from QwtDblRange.

int QwtCounter::stepButton1  )  const
 

returns the number of increment steps for button 1

int QwtCounter::stepButton2  )  const
 

returns the number of increment steps for button 2

int QwtCounter::stepButton3  )  const
 

returns the number of increment steps for button 3

virtual double QwtCounter::value  )  const [virtual]
 

Returns the current value.

Reimplemented from QwtDblRange.

void QwtCounter::valueChanged double  value  )  [protected]
 

This signal is emitted when the counter's value has changed

Parameters:
value The new value


Generated on Tue Nov 25 21:15:07 2003 for Qwt User's Guide by doxygen 1.3.4