meter.h

Go to the documentation of this file.

/*
 *   Copyright (C) 2007 Petri Damsten <damu@iki.fi>
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU Library General Public License as
 *   published by the Free Software Foundation; either version 2, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details
 *
 *   You should have received a copy of the GNU Library General Public
 *   License along with this program; if not, write to the
 *   Free Software Foundation, Inc.,
 *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */

#ifndef PLASMA_METER_H
#define PLASMA_METER_H

#include <plasma/plasma_export.h>
#include <plasma/dataengine.h>
#include <QtGui/QGraphicsWidget>

namespace Plasma
{

class MeterPrivate;

class PLASMA_EXPORT Meter : public QGraphicsWidget
{
    Q_OBJECT
    Q_ENUMS(MeterType)
    Q_PROPERTY(int minimum READ minimum WRITE setMinimum)
    Q_PROPERTY(int maximum READ maximum WRITE setMaximum)
    Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged)
    Q_PROPERTY(QString svg READ svg WRITE setSvg)
    Q_PROPERTY(MeterType meterType READ meterType WRITE setMeterType)

public:
    enum MeterType {
        BarMeterHorizontal,
        BarMeterVertical,
        AnalogMeter
    };

    explicit Meter(QGraphicsItem *parent = 0);

    ~Meter();

    int maximum() const;

    int minimum() const;

    int value() const;

    void setSvg(const QString &svg);

    QString svg() const;

    void setMeterType(MeterType type);

    MeterType meterType() const;

    void setLabel(int index, const QString &text);

    QString label(int index) const;

    void setLabelColor(int index, const QColor &color);

    QColor labelColor(int index) const;

    void setLabelFont(int index, const QFont &font);

    QFont labelFont(int index) const;

    void setLabelAlignment(int index, const Qt::Alignment alignment);

    Qt::Alignment labelAlignment(int index) const;

    QRectF labelRect(int index) const;

public Q_SLOTS:
    void dataUpdated(const QString &sourceName, const Plasma::DataEngine::Data &data);

    void setMaximum(int maximum);

    void setMinimum(int minimum);

    void setValue(int value);

Q_SIGNALS:
    void valueChanged(const int &value);

protected:
    virtual void paint(QPainter *p,
                       const QStyleOptionGraphicsItem *option,
                       QWidget *widget = 0);
    QSizeF sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const;

private:
    MeterPrivate *const d;
};

} // End of namepace

#endif