ground/gcs/src/libs/qwt/src/qwt_wheel.h

   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_WHEEL_H
  11 #define QWT_WHEEL_H
  12
  13 #include "qwt_global.h"
  14 #include <qwidget.h>
  15
  16 /*!
  17   \brief The Wheel Widget
  18
  19   The wheel widget can be used to change values over a very large range
  20   in very small steps. Using the setMass() member, it can be configured
  21   as a flying wheel.
  22
  23   The default range of the wheel is [0.0, 100.0]
  24
  25   \sa The radio example.
  26 */
  27 class QWT_EXPORT QwtWheel: public QWidget
  28 {
  29     Q_OBJECT
  30
  31     Q_PROPERTY( Qt::Orientation orientation
  32                 READ orientation WRITE setOrientation )
  33
  34     Q_PROPERTY( double value READ value WRITE setValue )
  35     Q_PROPERTY( double minimum READ minimum WRITE setMinimum )
  36     Q_PROPERTY( double maximum READ maximum WRITE setMaximum )
  37
  38     Q_PROPERTY( double singleStep READ singleStep WRITE setSingleStep )
  39     Q_PROPERTY( int pageStepCount READ pageStepCount WRITE setPageStepCount )
  40     Q_PROPERTY( bool stepAlignment READ stepAlignment WRITE setStepAlignment )
  41
  42     Q_PROPERTY( bool tracking READ isTracking WRITE setTracking )
  43     Q_PROPERTY( bool wrapping READ wrapping WRITE setWrapping )
  44     Q_PROPERTY( bool inverted READ isInverted WRITE setInverted )
  45
  46     Q_PROPERTY( double mass READ mass WRITE setMass )
  47     Q_PROPERTY( int updateInterval READ updateInterval WRITE setUpdateInterval )
  48
  49     Q_PROPERTY( double totalAngle READ totalAngle WRITE setTotalAngle )
  50     Q_PROPERTY( double viewAngle READ viewAngle WRITE setViewAngle )
  51     Q_PROPERTY( int tickCount READ tickCount WRITE setTickCount )
  52     Q_PROPERTY( int wheelWidth READ wheelWidth WRITE setWheelWidth )
  53     Q_PROPERTY( int borderWidth READ borderWidth WRITE setBorderWidth )
  54     Q_PROPERTY( int wheelBorderWidth READ wheelBorderWidth WRITE setWheelBorderWidth )
  55
  56 public:
  57     explicit QwtWheel( QWidget *parent = NULL );
  58     virtual ~QwtWheel();
  59
  60     double value() const;
  61
  62     void setOrientation( Qt::Orientation );
  63     Qt::Orientation orientation() const;
  64
  65     double totalAngle() const;
  66     double viewAngle() const;
  67
  68     void setTickCount( int );
  69     int tickCount() const;
  70
  71     void setWheelWidth( int );
  72     int wheelWidth() const;
  73
  74     void setWheelBorderWidth( int );
  75     int wheelBorderWidth() const;
  76
  77     void setBorderWidth( int );
  78     int borderWidth() const;
  79
  80     void setInverted( bool tf );
  81     bool isInverted() const;
  82
  83     void setWrapping( bool tf );
  84     bool wrapping() const;
  85
  86     void setSingleStep( double );
  87     double singleStep() const;
  88
  89     void setPageStepCount( int );
  90     int pageStepCount() const;
  91
  92     void setStepAlignment( bool on );
  93     bool stepAlignment() const;
  94
  95     void setRange( double vmin, double vmax );
  96
  97     void setMinimum( double min );
  98     double minimum() const;
  99
 100     void setMaximum( double max );
 101     double maximum() const;
 102
 103     void setUpdateInterval( int );
 104     int updateInterval() const;
 105
 106     void setTracking( bool enable );
 107     bool isTracking() const;
 108
 109     double mass() const;
 110
 111 public Q_SLOTS:
 112     void setValue( double );
 113     void setTotalAngle ( double );
 114     void setViewAngle( double );
 115     void setMass( double );
 116
 117 Q_SIGNALS:
 118
 119     /*!
 120       \brief Notify a change of value.
 121
 122       When tracking is enabled this signal will be emitted every
 123       time the value changes.
 124
 125       \param value new value
 126       \sa setTracking()
 127     */
 128     void valueChanged( double value );
 129
 130     /*!
 131       This signal is emitted when the user presses the
 132       the wheel with the mouse
 133     */
 134     void wheelPressed();
 135
 136     /*!
 137       This signal is emitted when the user releases the mouse
 138     */
 139     void wheelReleased();
 140
 141     /*!
 142       This signal is emitted when the user moves the
 143       wheel with the mouse.
 144
 145       \param value new value
 146     */
 147     void wheelMoved( double value );
 148
 149 protected:
 150     virtual void paintEvent( QPaintEvent * );
 151     virtual void mousePressEvent( QMouseEvent * );
 152     virtual void mouseReleaseEvent( QMouseEvent * );
 153     virtual void mouseMoveEvent( QMouseEvent * );
 154     virtual void keyPressEvent( QKeyEvent * );
 155     virtual void wheelEvent( QWheelEvent * );
 156     virtual void timerEvent( QTimerEvent * );
 157
 158     void stopFlying();
 159
 160     QRect wheelRect() const;
 161
 162     virtual QSize sizeHint() const;
 163     virtual QSize minimumSizeHint() const;
 164
 165     virtual void drawTicks( QPainter *, const QRectF & );
 166     virtual void drawWheelBackground( QPainter *, const QRectF & );
 167
 168     virtual double valueAt( const QPoint & ) const;
 169
 170 private:
 171     double alignedValue( double ) const;
 172     double boundedValue( double ) const;
 173
 174     class PrivateData;
 175     PrivateData *d_data;
 176 };
 177
 178 #endif