Qwt User's Guide 5.2.2
|
The Wheel Widget. More...
#include <qwt_wheel.h>
Public Types | |
enum | ScrollMode { ScrNone, ScrMouse, ScrTimer, ScrDirect, ScrPage } |
Public Slots | |
virtual void | fitValue (double val) |
virtual void | incValue (int steps) |
virtual void | setReadOnly (bool) |
virtual void | setValue (double val) |
Signals | |
void | sliderMoved (double value) |
void | sliderPressed () |
void | sliderReleased () |
void | valueChanged (double value) |
Public Member Functions | |
virtual void | incPages (int) |
int | internalBorder () const |
bool | isReadOnly () const |
bool | isValid () const |
double | mass () const |
double | maxValue () const |
virtual QSize | minimumSizeHint () const |
double | minValue () const |
Qt::Orientation | orientation () const |
int | pageSize () const |
bool | periodic () const |
QwtWheel (QWidget *parent=NULL) | |
void | setInternalBorder (int width) |
void | setMass (double val) |
virtual void | setOrientation (Qt::Orientation) |
void | setPeriodic (bool tf) |
void | setRange (double vmin, double vmax, double vstep=0.0, int pagesize=1) |
void | setStep (double) |
void | setTickCnt (int cnt) |
void | setTotalAngle (double angle) |
void | setTracking (bool enable) |
void | setUpdateTime (int t) |
void | setValid (bool valid) |
void | setViewAngle (double angle) |
void | setWheelWidth (int w) |
virtual QSize | sizeHint () const |
double | step () const |
void | stopMoving () |
int | tickCnt () const |
double | totalAngle () const |
double | value () const |
double | viewAngle () const |
virtual | ~QwtWheel () |
Protected Member Functions | |
void | draw (QPainter *, const QRect &) |
void | drawWheel (QPainter *, const QRect &) |
void | drawWheelBackground (QPainter *, const QRect &) |
double | exactPrevValue () const |
double | exactValue () const |
virtual void | getScrollMode (const QPoint &, int &scrollMode, int &direction) |
virtual double | getValue (const QPoint &) |
virtual void | keyPressEvent (QKeyEvent *e) |
void | layoutWheel (bool update=true) |
virtual void | mouseMoveEvent (QMouseEvent *e) |
double | mouseOffset () const |
virtual void | mousePressEvent (QMouseEvent *e) |
virtual void | mouseReleaseEvent (QMouseEvent *e) |
virtual void | paintEvent (QPaintEvent *e) |
virtual void | paletteChange (const QPalette &) |
double | prevValue () const |
virtual void | rangeChange () |
virtual void | resizeEvent (QResizeEvent *e) |
int | scrollMode () const |
void | setColorArray () |
void | setMouseOffset (double) |
virtual void | setPosition (const QPoint &) |
virtual void | stepChange () |
virtual void | timerEvent (QTimerEvent *e) |
virtual void | valueChange () |
virtual void | wheelEvent (QWheelEvent *e) |
The Wheel Widget.
The wheel widget can be used to change values over a very large range in very small steps. Using the setMass member, it can be configured as a flywheel.
enum QwtAbstractSlider::ScrollMode [inherited] |
Scroll mode
QwtWheel::QwtWheel | ( | QWidget * | parent = NULL | ) | [explicit] |
Constructor.
QwtWheel::~QwtWheel | ( | ) | [virtual] |
Destructor.
void QwtWheel::draw | ( | QPainter * | painter, |
const QRect & | |||
) | [protected] |
Redraw panel and wheel
painter | Painter |
void QwtWheel::drawWheel | ( | QPainter * | painter, |
const QRect & | r | ||
) | [protected] |
Redraw the wheel.
painter | painter |
r | contents rectangle |
void QwtWheel::drawWheelBackground | ( | QPainter * | painter, |
const QRect & | r | ||
) | [protected] |
Draw the Wheel's background gradient
painter | Painter |
r | Bounding rectangle |
double QwtDoubleRange::exactPrevValue | ( | ) | const [protected, inherited] |
Returns the exact previous value.
double QwtDoubleRange::exactValue | ( | ) | const [protected, inherited] |
Returns the exact value.
The exact value is the value which QwtDoubleRange::value would return if the value were not adjusted to the step raster. It differs from the current value only if QwtDoubleRange::fitValue or QwtDoubleRange::incValue have been used before. This function is intended for internal use in derived classes.
void QwtAbstractSlider::fitValue | ( | double | value | ) | [virtual, slot, inherited] |
Set the slider's value to the nearest integer multiple of the step size.
value | Value |
Reimplemented from QwtDoubleRange.
void QwtWheel::getScrollMode | ( | const QPoint & | p, |
int & | scrollMode, | ||
int & | direction | ||
) | [protected, virtual] |
Determine the scrolling mode and direction corresponding to a specified point.
p | point |
scrollMode | scrolling mode |
direction | direction |
Implements QwtAbstractSlider.
double QwtWheel::getValue | ( | const QPoint & | p | ) | [protected, virtual] |
Determine the value corresponding to a specified point.
Implements QwtAbstractSlider.
void QwtDoubleRange::incPages | ( | int | nPages | ) | [virtual, inherited] |
Increment the value by a specified number of pages.
nPages | Number of pages to increment. A negative number decrements the value. |
void QwtAbstractSlider::incValue | ( | int | steps | ) | [virtual, slot, inherited] |
Increment the value by a specified number of steps.
steps | number of steps |
Reimplemented from QwtDoubleRange.
int QwtWheel::internalBorder | ( | ) | const |
bool QwtAbstractSlider::isReadOnly | ( | ) | const [inherited] |
In read only mode the slider can't be controlled by mouse or keyboard.
bool QwtAbstractSlider::isValid | ( | ) | const [inline, inherited] |
Reimplemented from QwtDoubleRange.
void QwtAbstractSlider::keyPressEvent | ( | QKeyEvent * | e | ) | [protected, virtual, inherited] |
Handles key events
e | Key event |
Reimplemented in QwtCompass, and QwtDial.
void QwtWheel::layoutWheel | ( | bool | update = true | ) | [protected] |
Recalculate the slider's geometry and layout based on.
double QwtWheel::mass | ( | ) | const [virtual] |
Reimplemented from QwtAbstractSlider.
double QwtDoubleRange::maxValue | ( | ) | const [inherited] |
Returns the value of the second border of the range.
maxValue returns the value which has been specified as the second parameter in QwtDoubleRange::setRange.
QSize QwtWheel::minimumSizeHint | ( | ) | const [virtual] |
Return a minimum size hint.
double QwtDoubleRange::minValue | ( | ) | const [inherited] |
Returns the value at the first border of the range.
minValue returns the value which has been specified as the first parameter in setRange().
void QwtAbstractSlider::mouseMoveEvent | ( | QMouseEvent * | e | ) | [protected, virtual, inherited] |
Mouse Move Event handler
e | Mouse event |
void QwtAbstractSlider::mousePressEvent | ( | QMouseEvent * | e | ) | [protected, virtual, inherited] |
Mouse press event handler
e | Mouse event |
void QwtAbstractSlider::mouseReleaseEvent | ( | QMouseEvent * | e | ) | [protected, virtual, inherited] |
Mouse Release Event handler
e | Mouse event |
Qt::Orientation QwtAbstractSlider::orientation | ( | ) | const [inherited] |
int QwtDoubleRange::pageSize | ( | ) | const [inherited] |
Returns the page size in steps.
void QwtWheel::paintEvent | ( | QPaintEvent * | e | ) | [protected, virtual] |
Qt Paint Event.
void QwtWheel::paletteChange | ( | const QPalette & | ) | [protected, virtual] |
Call update() when the palette changes.
bool QwtDoubleRange::periodic | ( | ) | const [inherited] |
Returns true if the range is periodic.
double QwtDoubleRange::prevValue | ( | ) | const [protected, inherited] |
Returns the previous value.
void QwtDoubleRange::rangeChange | ( | ) | [protected, virtual, inherited] |
Notify a change of the range.
This virtual function is called whenever the range changes. The default implementation does nothing.
Reimplemented in QwtCounter, QwtDial, and QwtSlider.
void QwtWheel::resizeEvent | ( | QResizeEvent * | e | ) | [protected, virtual] |
Qt Resize Event.
void QwtWheel::setColorArray | ( | ) | [protected] |
Set up the color array for the background pixmap.
void QwtWheel::setInternalBorder | ( | int | w | ) |
Set the internal border width of the wheel.
The internal border must not be smaller than 1 and is limited in dependence on the wheel's size. Values outside the allowed range will be clipped.
The internal border defaults to 2.
w | border width |
void QwtWheel::setMass | ( | double | val | ) | [virtual] |
Set the mass of the wheel.
Assigning a mass turns the wheel into a flywheel.
val | the wheel's mass |
Reimplemented from QwtAbstractSlider.
void QwtWheel::setOrientation | ( | Qt::Orientation | o | ) | [virtual] |
Set the wheel's orientation.
o | Orientation. Allowed values are Qt::Horizontal and Qt::Vertical. Defaults to Qt::Horizontal. |
Reimplemented from QwtAbstractSlider.
void QwtDoubleRange::setPeriodic | ( | bool | tf | ) | [inherited] |
Make the range periodic.
When the range is periodic, the value will be set to a point inside the interval such that
point = value + n * width
if the user tries to set a new value which is outside the range. If the range is nonperiodic (the default), values outside the range will be clipped.
tf | true for a periodic range |
void QwtAbstractSlider::setPosition | ( | const QPoint & | p | ) | [protected, virtual, inherited] |
Move the slider to a specified point, adjust the value and emit signals if necessary.
void QwtDoubleRange::setRange | ( | double | vmin, |
double | vmax, | ||
double | vstep = 0.0 , |
||
int | pageSize = 1 |
||
) | [inherited] |
Specify range and step size.
vmin | lower boundary of the interval |
vmax | higher boundary of the interval |
vstep | step width |
pageSize | page size in steps |
void QwtAbstractSlider::setReadOnly | ( | bool | readOnly | ) | [virtual, slot, inherited] |
En/Disable read only mode
In read only mode the slider can't be controlled by mouse or keyboard.
readOnly | Enables in case of true |
void QwtDoubleRange::setStep | ( | double | vstep | ) | [inherited] |
Change the step raster.
vstep | new step width |
Reimplemented in QwtCounter.
void QwtWheel::setTickCnt | ( | int | cnt | ) |
Adjust the number of grooves in the wheel's surface.
The number of grooves is limited to 6 <= cnt <= 50. Values outside this range will be clipped. The default value is 10.
cnt | Number of grooves per 360 degrees |
void QwtWheel::setTotalAngle | ( | double | angle | ) |
Set the total angle which the wheel can be turned.
One full turn of the wheel corresponds to an angle of 360 degrees. A total angle of n*360 degrees means that the wheel has to be turned n times around its axis to get from the minimum value to the maximum value.
The default setting of the total angle is 360 degrees.
angle | total angle in degrees |
void QwtAbstractSlider::setTracking | ( | bool | enable | ) | [inherited] |
Enables or disables tracking.
If tracking is enabled, the slider emits a valueChanged() signal whenever its value changes (the default behaviour). If tracking is disabled, the value changed() signal will only be emitted if:
Tracking is enabled by default.
enable | true (enable) or false (disable) tracking. |
void QwtAbstractSlider::setUpdateTime | ( | int | t | ) | [inherited] |
Specify the update interval for automatic scrolling.
t | update interval in milliseconds |
void QwtAbstractSlider::setValid | ( | bool | valid | ) | [inline, inherited] |
void QwtAbstractSlider::setValue | ( | double | val | ) | [virtual, slot, inherited] |
Move the slider to a specified value.
This function can be used to move the slider to a value which is not an integer multiple of the step size.
val | new value |
Reimplemented from QwtDoubleRange.
void QwtWheel::setViewAngle | ( | double | angle | ) |
Specify the visible portion of the wheel.
You may use this function for fine-tuning the appearance of the wheel. The default value is 175 degrees. The value is limited from 10 to 175 degrees.
angle | Visible angle in degrees |
void QwtWheel::setWheelWidth | ( | int | w | ) |
Set the width of the wheel.
Corresponds to the wheel height for horizontal orientation, and the wheel width for vertical orientation.
w | the wheel's width |
QSize QwtWheel::sizeHint | ( | ) | const [virtual] |
void QwtAbstractSlider::sliderMoved | ( | double | value | ) | [signal, inherited] |
This signal is emitted when the user moves the slider with the mouse.
value | new value |
void QwtAbstractSlider::sliderPressed | ( | ) | [signal, inherited] |
This signal is emitted when the user presses the movable part of the slider (start ScrMouse Mode).
void QwtAbstractSlider::sliderReleased | ( | ) | [signal, inherited] |
This signal is emitted when the user releases the movable part of the slider.
double QwtDoubleRange::step | ( | ) | const [inherited] |
void QwtDoubleRange::stepChange | ( | ) | [protected, virtual, inherited] |
Notify a change of the step size.
This virtual function is called whenever the step size changes. The default implementation does nothing.
void QwtAbstractSlider::stopMoving | ( | ) | [inherited] |
Stop updating if automatic scrolling is active.
int QwtWheel::tickCnt | ( | ) | const |
void QwtAbstractSlider::timerEvent | ( | QTimerEvent * | e | ) | [protected, virtual, inherited] |
Qt timer event
e | Timer event |
double QwtWheel::totalAngle | ( | ) | const |
double QwtDoubleRange::value | ( | ) | const [inherited] |
Returns the current value.
Reimplemented in QwtCounter.
void QwtWheel::valueChange | ( | ) | [protected, virtual] |
Notify value change.
Reimplemented from QwtAbstractSlider.
void QwtAbstractSlider::valueChanged | ( | double | value | ) | [signal, inherited] |
Notify a change of value.
In the default setting (tracking enabled), this signal will be emitted every time the value changes ( see setTracking() ).
value | new value |
double QwtWheel::viewAngle | ( | ) | const |
void QwtAbstractSlider::wheelEvent | ( | QWheelEvent * | e | ) | [protected, virtual, inherited] |
Wheel Event handler
e | Whell event |