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
 *****************************************************************************/

// vim: expandtab

#ifndef QWT_DIAL_H
#define QWT_DIAL_H 1

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

class QwtDialNeedle;
class QwtDial;

class QWT_EXPORT QwtDialScaleDraw: public QwtRoundScaleDraw
{
public:
    explicit QwtDialScaleDraw(QwtDial *);
    virtual QwtText label(double value) const;

    void setPenWidth(uint);
    uint penWidth() const;

private:
    QwtDial *d_parent;
    int d_penWidth;
};

class QWT_EXPORT QwtDial: public QwtAbstractSlider
{
    Q_OBJECT

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

    Q_PROPERTY(bool visibleBackground READ hasVisibleBackground WRITE showBackground)
    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 ScaleOptions
    {
        ScaleBackbone = 1,
        ScaleTicks = 2,
        ScaleLabel = 4
    };

    enum Mode
    {
        RotateNeedle,
        RotateScale
    };

    enum Direction
    {
        Clockwise,
        CounterClockwise
    };

    explicit QwtDial( QWidget *parent = NULL);
#if QT_VERSION < 0x040000
    explicit QwtDial( QWidget *parent, const char *name);
#endif

    virtual ~QwtDial();

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

    bool hasVisibleBackground() const;
    void showBackground(bool);

    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 setScaleOptions(int);
    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();

    QRect boundingRect() const;
    QRect contentsRect() const;
    virtual QRect scaleContentsRect() 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 resizeEvent(QResizeEvent *);
    virtual void keyPressEvent(QKeyEvent *);

    virtual void updateMask();

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

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

    virtual void drawScaleContents(QPainter *painter, const QPoint &center, 
        int radius) const;

    virtual void drawNeedle(QPainter *, const QPoint &, 
        int 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 &, 
        int &scrollMode, int &direction);

private:
    void initDial();

    class PrivateData;
    PrivateData *d_data;
};

#endif