qwt_dial.h

/* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
 * Qwt Widget Library
 * Copyright (C) 1997   Josef Wilgen
 * Copyright (C) 2002   Uwe Rathmann
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the Qwt License, Version 1.0
 *****************************************************************************/

#ifndef QWT_DIAL_H
#define QWT_DIAL_H 1

#include "qwt_global.h"
#include "qwt_abstract_slider.h"
#include "qwt_round_scale_draw.h"
#include <qframe.h>
#include <qpalette.h>

class QwtDialNeedle;
class QwtDial;

class QWT_EXPORT QwtDialScaleDraw: public QwtRoundScaleDraw
{
public:
    explicit QwtDialScaleDraw( QwtDial * );

    virtual QwtText label( double value ) const;

    void setPenWidth( double );
    double penWidth() const;

private:
    QwtDial *d_parent;
    double d_penWidth;
};

class QWT_EXPORT QwtDial: public QwtAbstractSlider
{
    Q_OBJECT

    Q_ENUMS( Shadow )
    Q_ENUMS( Mode )
    Q_ENUMS( Direction )

    Q_PROPERTY( int lineWidth READ lineWidth WRITE setLineWidth )
    Q_PROPERTY( Shadow frameShadow READ frameShadow WRITE setFrameShadow )
    Q_PROPERTY( Mode mode READ mode WRITE setMode )
    Q_PROPERTY( double origin READ origin WRITE setOrigin )
    Q_PROPERTY( bool wrapping READ wrapping WRITE setWrapping )
    Q_PROPERTY( Direction direction READ direction WRITE setDirection )

    friend class QwtDialScaleDraw;
public:

    enum Shadow
    {
        Plain = QFrame::Plain,

        Raised = QFrame::Raised,

        Sunken = QFrame::Sunken
    };

    enum Mode
    {
        RotateNeedle,

        RotateScale
    };

    enum Direction
    {
        Clockwise,

        CounterClockwise
    };

    explicit QwtDial( QWidget *parent = NULL );
    virtual ~QwtDial();

    void setFrameShadow( Shadow );
    Shadow frameShadow() const;

    void setLineWidth( int );
    int lineWidth() const;

    void setMode( Mode );
    Mode mode() const;

    virtual void setWrapping( bool );
    bool wrapping() const;

    virtual void setScale( int maxMajIntv, int maxMinIntv, double step = 0.0 );

    void setScaleArc( double min, double max );
    void setScaleComponents( QwtAbstractScaleDraw::ScaleComponents );
    void setScaleTicks( int minLen, int medLen, int majLen, int penWidth = 1 );

    double minScaleArc() const;
    double maxScaleArc() const;

    virtual void setOrigin( double );
    double origin() const;

    void setDirection( Direction );
    Direction direction() const;

    virtual void setNeedle( QwtDialNeedle * );
    const QwtDialNeedle *needle() const;
    QwtDialNeedle *needle();

    QRectF boundingRect() const;
    QRectF innerRect() const;
    virtual QRectF scaleInnerRect() const;

    virtual QSize sizeHint() const;
    virtual QSize minimumSizeHint() const;

    virtual void setScaleDraw( QwtDialScaleDraw * );

    QwtDialScaleDraw *scaleDraw();
    const QwtDialScaleDraw *scaleDraw() const;

protected:
    virtual void paintEvent( QPaintEvent * );
    virtual void keyPressEvent( QKeyEvent * );

    virtual void drawFrame( QPainter *p );
    virtual void drawContents( QPainter * ) const;
    virtual void drawFocusIndicator( QPainter * ) const;

    virtual void drawScale( 
        QPainter *, const QPointF &center,
        double radius, double origin, 
        double arcMin, double arcMax ) const;

    virtual void drawScaleContents( QPainter *painter, 
        const QPointF &center, double radius ) const;

    virtual void drawNeedle( QPainter *, const QPointF &,
        double radius, double direction, QPalette::ColorGroup ) const;

    virtual QwtText scaleLabel( double ) const;
    void updateScale();

    virtual void rangeChange();
    virtual void valueChange();

    virtual double getValue( const QPoint & );
    virtual void getScrollMode( const QPoint &,
        QwtAbstractSlider::ScrollMode &, int &direction ) const;

private:
    void initDial();

    class PrivateData;
    PrivateData *d_data;
};

#endif