[8127] | 1 | /* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
|
---|
| 2 | * Qwt Widget Library
|
---|
| 3 | * Copyright (C) 1997 Josef Wilgen
|
---|
| 4 | * Copyright (C) 2002 Uwe Rathmann
|
---|
| 5 | *
|
---|
| 6 | * This library is free software; you can redistribute it and/or
|
---|
| 7 | * modify it under the terms of the Qwt License, Version 1.0
|
---|
| 8 | *****************************************************************************/
|
---|
| 9 |
|
---|
| 10 | #ifndef QWT_ABSTRACT_SLIDER_H
|
---|
| 11 | #define QWT_ABSTRACT_SLIDER_H
|
---|
| 12 |
|
---|
| 13 | #include "qwt_global.h"
|
---|
| 14 | #include "qwt_abstract_scale.h"
|
---|
| 15 |
|
---|
| 16 | /*!
|
---|
| 17 | \brief An abstract base class for slider widgets with a scale
|
---|
| 18 |
|
---|
| 19 | A slider widget displays a value according to a scale.
|
---|
| 20 | The class is designed as a common super class for widgets like
|
---|
| 21 | QwtKnob, QwtDial and QwtSlider.
|
---|
| 22 |
|
---|
| 23 | When the slider is nor readOnly() its value can be modified
|
---|
| 24 | by keyboard, mouse and wheel inputs.
|
---|
| 25 |
|
---|
| 26 | The range of the slider is divided into a number of steps from
|
---|
| 27 | which the value increments according to user inputs depend.
|
---|
| 28 | Only for linear scales the number of steps correspond with
|
---|
| 29 | a fixed step size.
|
---|
| 30 | */
|
---|
| 31 |
|
---|
| 32 | class QWT_EXPORT QwtAbstractSlider: public QwtAbstractScale
|
---|
| 33 | {
|
---|
| 34 | Q_OBJECT
|
---|
| 35 |
|
---|
| 36 | Q_PROPERTY( double value READ value WRITE setValue )
|
---|
| 37 |
|
---|
| 38 | Q_PROPERTY( uint totalSteps READ totalSteps WRITE setTotalSteps )
|
---|
| 39 | Q_PROPERTY( uint singleSteps READ singleSteps WRITE setSingleSteps )
|
---|
| 40 | Q_PROPERTY( uint pageSteps READ pageSteps WRITE setPageSteps )
|
---|
| 41 | Q_PROPERTY( bool stepAlignment READ stepAlignment WRITE setStepAlignment )
|
---|
| 42 |
|
---|
| 43 | Q_PROPERTY( bool readOnly READ isReadOnly WRITE setReadOnly )
|
---|
| 44 | Q_PROPERTY( bool tracking READ isTracking WRITE setTracking )
|
---|
| 45 | Q_PROPERTY( bool wrapping READ wrapping WRITE setWrapping )
|
---|
| 46 |
|
---|
| 47 | Q_PROPERTY( bool invertedControls READ invertedControls WRITE setInvertedControls )
|
---|
| 48 |
|
---|
| 49 | public:
|
---|
| 50 | explicit QwtAbstractSlider( QWidget *parent = NULL );
|
---|
| 51 | virtual ~QwtAbstractSlider();
|
---|
| 52 |
|
---|
| 53 | void setValid( bool );
|
---|
| 54 | bool isValid() const;
|
---|
| 55 |
|
---|
| 56 | double value() const;
|
---|
| 57 |
|
---|
| 58 | void setWrapping( bool );
|
---|
| 59 | bool wrapping() const;
|
---|
| 60 |
|
---|
| 61 | void setTotalSteps( uint );
|
---|
| 62 | uint totalSteps() const;
|
---|
| 63 |
|
---|
| 64 | void setSingleSteps( uint );
|
---|
| 65 | uint singleSteps() const;
|
---|
| 66 |
|
---|
| 67 | void setPageSteps( uint );
|
---|
| 68 | uint pageSteps() const;
|
---|
| 69 |
|
---|
| 70 | void setStepAlignment( bool );
|
---|
| 71 | bool stepAlignment() const;
|
---|
| 72 |
|
---|
| 73 | void setTracking( bool );
|
---|
| 74 | bool isTracking() const;
|
---|
| 75 |
|
---|
| 76 | void setReadOnly( bool );
|
---|
| 77 | bool isReadOnly() const;
|
---|
| 78 |
|
---|
| 79 | void setInvertedControls( bool );
|
---|
| 80 | bool invertedControls() const;
|
---|
| 81 |
|
---|
| 82 | public Q_SLOTS:
|
---|
| 83 | void setValue( double val );
|
---|
| 84 |
|
---|
| 85 | Q_SIGNALS:
|
---|
| 86 |
|
---|
| 87 | /*!
|
---|
| 88 | \brief Notify a change of value.
|
---|
| 89 |
|
---|
| 90 | When tracking is enabled (default setting),
|
---|
| 91 | this signal will be emitted every time the value changes.
|
---|
| 92 |
|
---|
| 93 | \param value New value
|
---|
| 94 |
|
---|
| 95 | \sa setTracking(), sliderMoved()
|
---|
| 96 | */
|
---|
| 97 | void valueChanged( double value );
|
---|
| 98 |
|
---|
| 99 | /*!
|
---|
| 100 | This signal is emitted when the user presses the
|
---|
| 101 | movable part of the slider.
|
---|
| 102 | */
|
---|
| 103 | void sliderPressed();
|
---|
| 104 |
|
---|
| 105 | /*!
|
---|
| 106 | This signal is emitted when the user releases the
|
---|
| 107 | movable part of the slider.
|
---|
| 108 | */
|
---|
| 109 | void sliderReleased();
|
---|
| 110 |
|
---|
| 111 | /*!
|
---|
| 112 | This signal is emitted when the user moves the
|
---|
| 113 | slider with the mouse.
|
---|
| 114 |
|
---|
| 115 | \param value New value
|
---|
| 116 |
|
---|
| 117 | \sa valueChanged()
|
---|
| 118 | */
|
---|
| 119 | void sliderMoved( double value );
|
---|
| 120 |
|
---|
| 121 | protected:
|
---|
| 122 | virtual void mousePressEvent( QMouseEvent * );
|
---|
| 123 | virtual void mouseReleaseEvent( QMouseEvent * );
|
---|
| 124 | virtual void mouseMoveEvent( QMouseEvent * );
|
---|
| 125 | virtual void keyPressEvent( QKeyEvent * );
|
---|
| 126 | virtual void wheelEvent( QWheelEvent * );
|
---|
| 127 |
|
---|
| 128 | /*!
|
---|
| 129 | \brief Determine what to do when the user presses a mouse button.
|
---|
| 130 |
|
---|
| 131 | \param pos Mouse position
|
---|
| 132 |
|
---|
| 133 | \retval True, when pos is a valid scroll position
|
---|
| 134 | \sa scrolledTo()
|
---|
| 135 | */
|
---|
| 136 | virtual bool isScrollPosition( const QPoint &pos ) const = 0;
|
---|
| 137 |
|
---|
| 138 | /*!
|
---|
| 139 | \brief Determine the value for a new position of the
|
---|
| 140 | movable part of the slider
|
---|
| 141 |
|
---|
| 142 | \param pos Mouse position
|
---|
| 143 |
|
---|
| 144 | \return Value for the mouse position
|
---|
| 145 | \sa isScrollPosition()
|
---|
| 146 | */
|
---|
| 147 | virtual double scrolledTo( const QPoint &pos ) const = 0;
|
---|
| 148 |
|
---|
| 149 | void incrementValue( int numSteps );
|
---|
| 150 |
|
---|
| 151 | virtual void scaleChange();
|
---|
| 152 |
|
---|
| 153 | protected:
|
---|
| 154 | virtual void sliderChange();
|
---|
| 155 |
|
---|
| 156 | double incrementedValue(
|
---|
| 157 | double value, int stepCount ) const;
|
---|
| 158 |
|
---|
| 159 | private:
|
---|
| 160 | double alignedValue( double ) const;
|
---|
| 161 | double boundedValue( double ) const;
|
---|
| 162 |
|
---|
| 163 | class PrivateData;
|
---|
| 164 | PrivateData *d_data;
|
---|
| 165 | };
|
---|
| 166 |
|
---|
| 167 | #endif
|
---|