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

QwtCounter Class Reference

Inheritance diagram for QwtCounter:

Inheritance graph
[legend]
Collaboration diagram for QwtCounter:

Collaboration graph
[legend]
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)));

Definition at line 63 of file qwt_counter.h.

Public Types

enum  Button {
  Button1,
  Button2,
  Button3,
  ButtonCnt
}

Signals

void buttonReleased (double value)
void valueChanged (double value)

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

virtual void rangeChange ()
virtual void fontChange (const QFont &f)


Member Enumeration Documentation

enum QwtCounter::Button
 

Button index Definition at line 81 of file qwt_counter.h.


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.
Definition at line 27 of file qwt_counter.cpp.

References setNumButtons(), QwtDblRange::setRange(), and setValue().


Member Function Documentation

void QwtCounter::buttonReleased double  value  )  [signal]
 

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.

Definition at line 78 of file qwt_counter.cpp.

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
Definition at line 308 of file qwt_counter.cpp.

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
Definition at line 127 of file qwt_counter.cpp.

double QwtCounter::maxVal  )  const
 

returns the maximum value of the range

Definition at line 94 of file qwt_counter.h.

References QwtDblRange::maxValue().

double QwtCounter::minVal  )  const
 

returns the minimum value of the range

Definition at line 90 of file qwt_counter.h.

References QwtDblRange::minValue().

int QwtCounter::numButtons  )  const
 

Returns:
The number of buttons on each side of the widget.
Definition at line 247 of file qwt_counter.cpp.

void QwtCounter::rangeChange  )  [protected, virtual]
 

Notify change of range.

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

Reimplemented from QwtDblRange.

Definition at line 296 of file qwt_counter.cpp.

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
Definition at line 115 of file qwt_counter.cpp.

void QwtCounter::setMaxValue double  m  ) 
 

sets the maximum value of the range

Definition at line 96 of file qwt_counter.h.

References QwtDblRange::minValue(), QwtDblRange::setRange(), and QwtDblRange::step().

void QwtCounter::setMinValue double  m  ) 
 

sets the minimum value of the range

Definition at line 92 of file qwt_counter.h.

References QwtDblRange::maxValue(), QwtDblRange::setRange(), and QwtDblRange::step().

void QwtCounter::setNumButtons int  n  ) 
 

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

Parameters:
n Number of buttons
Definition at line 222 of file qwt_counter.cpp.

Referenced by QwtCounter().

void QwtCounter::setStep double  s  ) 
 

sets the step size

Reimplemented from QwtDblRange.

Definition at line 88 of file qwt_counter.h.

References QwtDblRange::setStep().

void QwtCounter::setStepButton1 int  nSteps  ) 
 

set the number of increment steps for button 1

Definition at line 98 of file qwt_counter.h.

void QwtCounter::setStepButton2 int  nSteps  ) 
 

set the number of increment steps for button 2

Definition at line 102 of file qwt_counter.h.

void QwtCounter::setStepButton3 int  nSteps  ) 
 

set the number of increment steps for button 3

Definition at line 106 of file qwt_counter.h.

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.

Definition at line 142 of file qwt_counter.cpp.

References QwtDblRange::setValue(), and value().

Referenced by QwtCounter().

QSize QwtCounter::sizeHint  )  const [virtual]
 

A size hint.

Definition at line 315 of file qwt_counter.cpp.

References step().

QSizePolicy QwtCounter::sizePolicy  )  const [virtual]
 

Preferred/Fixed.

Definition at line 350 of file qwt_counter.cpp.

double QwtCounter::step  )  const
 

returns the step size

Reimplemented from QwtDblRange.

Definition at line 86 of file qwt_counter.h.

References QwtDblRange::step().

Referenced by sizeHint().

int QwtCounter::stepButton1  )  const
 

returns the number of increment steps for button 1

Definition at line 100 of file qwt_counter.h.

int QwtCounter::stepButton2  )  const
 

returns the number of increment steps for button 2

Definition at line 104 of file qwt_counter.h.

int QwtCounter::stepButton3  )  const
 

returns the number of increment steps for button 3

Definition at line 108 of file qwt_counter.h.

virtual double QwtCounter::value  )  const [virtual]
 

Returns the current value.

Reimplemented from QwtDblRange.

Definition at line 109 of file qwt_counter.h.

References QwtDblRange::value().

Referenced by setValue().

void QwtCounter::valueChanged double  value  )  [signal]
 

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

Parameters:
value The new value


Generated on Tue Nov 16 21:12:24 2004 for Qwt User's Guide by doxygen 1.3.8