qwt_scale_widget.h

Go to the documentation of this file.

/******************************************************************************
 * 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_SCALE_WIDGET_H
#define QWT_SCALE_WIDGET_H

#include "qwt_global.h"
#include "qwt_text.h"
#include "qwt_scale_draw.h"

#include <qwidget.h>
#include <qfont.h>
#include <qcolor.h>
#include <qstring.h>

class QPainter;
class QwtTransform;
class QwtScaleDiv;
class QwtColorMap;

class QWT_EXPORT QwtScaleWidget : public QWidget
{
    Q_OBJECT

  public:
    enum LayoutFlag
    {
        TitleInverted = 1
    };

    Q_DECLARE_FLAGS( LayoutFlags, LayoutFlag )

    explicit QwtScaleWidget( QWidget* parent = NULL );
    explicit QwtScaleWidget( QwtScaleDraw::Alignment, QWidget* parent = NULL );
    virtual ~QwtScaleWidget();

  Q_SIGNALS:
    void scaleDivChanged();

  public:
    void setTitle( const QString& title );
    void setTitle( const QwtText& title );
    QwtText title() const;

    void setLayoutFlag( LayoutFlag, bool on );
    bool testLayoutFlag( LayoutFlag ) const;

    void setBorderDist( int dist1, int dist2 );
    int startBorderDist() const;
    int endBorderDist() const;

    void getBorderDistHint( int& start, int& end ) const;

    void getMinBorderDist( int& start, int& end ) const;
    void setMinBorderDist( int start, int end );

    void setMargin( int );
    int margin() const;

    void setSpacing( int );
    int spacing() const;

    void setScaleDiv( const QwtScaleDiv& );
    void setTransformation( QwtTransform* );

    void setScaleDraw( QwtScaleDraw* );
    const QwtScaleDraw* scaleDraw() const;
    QwtScaleDraw* scaleDraw();

    void setLabelAlignment( Qt::Alignment );
    void setLabelRotation( double rotation );

    void setColorBarEnabled( bool );
    bool isColorBarEnabled() const;

    void setColorBarWidth( int );
    int colorBarWidth() const;

    void setColorMap( const QwtInterval&, QwtColorMap* );

    QwtInterval colorBarInterval() const;
    const QwtColorMap* colorMap() const;

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

    int titleHeightForWidth( int width ) const;
    int dimForLength( int length, const QFont& scaleFont ) const;

    void drawColorBar( QPainter*, const QRectF& ) const;
    void drawTitle( QPainter*, QwtScaleDraw::Alignment,
        const QRectF& rect ) const;

    void setAlignment( QwtScaleDraw::Alignment );
    QwtScaleDraw::Alignment alignment() const;

    QRectF colorBarRect( const QRectF& ) const;

  protected:
    virtual void paintEvent( QPaintEvent* ) QWT_OVERRIDE;
    virtual void resizeEvent( QResizeEvent* ) QWT_OVERRIDE;
    virtual void changeEvent( QEvent* ) QWT_OVERRIDE;

    void draw( QPainter* ) const;

    void scaleChange();
    void layoutScale( bool update_geometry = true );

  private:
    void initScale( QwtScaleDraw::Alignment );

    class PrivateData;
    PrivateData* m_data;
};

Q_DECLARE_OPERATORS_FOR_FLAGS( QwtScaleWidget::LayoutFlags )

#endif