qwt_abstract_slider.h

/******************************************************************************
 * 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
 *
 * Modified by ChenZongYan in 2024 <czy.t@163.com>
 *   Summary of major modifications (see ChangeLog.md for full history):
 *   1. CMake build system & C++11 throughout.
 *   2. Core panner/ zoomer refactored:
 *        - QwtPanner → QwtCachePanner (pixmap-cache version)
 *        - New real-time QwtPlotPanner derived from QwtPicker.
 *   3. Zoomer supports multi-axis.
 *   4. Parasite-plot framework:
 *        - QwtFigure, QwtPlotParasiteLayout, QwtPlotTransparentCanvas,
 *        - QwtPlotScaleEventDispatcher, built-in pan/zoom on axis.
 *   5. New picker: QwtPlotSeriesDataPicker (works with date axis).
 *   6. Raster & color-map extensions:
 *        - QwtGridRasterData (2-D table + interpolation)
 *        - QwtLinearColorMap::stopColors(), stopPos() API rename.
 *   7. Bar-chart: expose pen/brush control.
 *   8. Amalgamated build: single QwtPlot.h / QwtPlot.cpp pair in src-amalgamate.
 *****************************************************************************/
 
#ifndef QWT_ABSTRACT_SLIDER_H
#define QWT_ABSTRACT_SLIDER_H
 
#include "qwt_global.h"
#include "qwt_abstract_scale.h"
 
class QWT_EXPORT QwtAbstractSlider : public QwtAbstractScale
{
    Q_OBJECT
 
    Q_PROPERTY( double value READ value WRITE setValue NOTIFY valueChanged USER true )
 
    Q_PROPERTY( uint totalSteps READ totalSteps WRITE setTotalSteps )
    Q_PROPERTY( uint singleSteps READ singleSteps WRITE setSingleSteps )
    Q_PROPERTY( uint pageSteps READ pageSteps WRITE setPageSteps )
    Q_PROPERTY( bool stepAlignment READ stepAlignment WRITE setStepAlignment )
 
    Q_PROPERTY( bool readOnly READ isReadOnly WRITE setReadOnly )
    Q_PROPERTY( bool tracking READ isTracking WRITE setTracking )
    Q_PROPERTY( bool wrapping READ wrapping WRITE setWrapping )
 
    Q_PROPERTY( bool invertedControls READ invertedControls WRITE setInvertedControls )
 
  public:
    explicit QwtAbstractSlider( QWidget* parent = nullptr );
    
    virtual ~QwtAbstractSlider();
 
    void setValid( bool );
    
    bool isValid() const;
 
    double value() const;
 
    void setWrapping( bool );
    
    bool wrapping() const;
 
    void setTotalSteps( uint );
    
    uint totalSteps() const;
 
    void setSingleSteps( uint );
    
    uint singleSteps() const;
 
    void setPageSteps( uint );
    
    uint pageSteps() const;
 
    void setStepAlignment( bool );
    
    bool stepAlignment() const;
 
    void setTracking( bool );
    
    bool isTracking() const;
 
    void setReadOnly( bool );
    
    bool isReadOnly() const;
 
    void setInvertedControls( bool );
    
    bool invertedControls() const;
 
  public Q_SLOTS:
    void setValue( double value );
 
  Q_SIGNALS:
 
    void valueChanged( double value );
 
    void sliderPressed();
 
    void sliderReleased();
 
    void sliderMoved( double value );
 
  protected:
    virtual void mousePressEvent( QMouseEvent* ) override;
    
    virtual void mouseReleaseEvent( QMouseEvent* ) override;
    
    virtual void mouseMoveEvent( QMouseEvent* ) override;
    
    virtual void keyPressEvent( QKeyEvent* ) override;
    
    virtual void wheelEvent( QWheelEvent* ) override;
 
    virtual bool isScrollPosition( const QPoint& pos ) const = 0;
 
    virtual double scrolledTo( const QPoint& pos ) const = 0;
 
    void incrementValue( int stepCount );
 
    virtual void scaleChange() override;
 
  protected:
    virtual void sliderChange();
 
    double incrementedValue(
        double value, int stepCount ) const;
 
  private:
    double alignedValue( double ) const;
    double boundedValue( double ) const;
 
    class PrivateData;
    PrivateData* m_data;
};
 
#endif