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);
 
    ~QwtAbstractSlider() override;
 
    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;
 
    // Determine what to do when the user presses a mouse button
    virtual bool isScrollPosition(const QPoint& pos) const = 0;
 
    // Determine the value for a new position of the movable part of the slider
    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;
 
    QWT_DECLARE_PRIVATE(QwtAbstractSlider)
};
 
#endif