qwt_abstract_slider.h
5.04 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
/* -*- 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
*****************************************************************************/
#ifndef QWT_ABSTRACT_SLIDER_H
#define QWT_ABSTRACT_SLIDER_H
#include "qwt_global.h"
#include "qwt_double_range.h"
#include <qwidget.h>
/*!
\brief An abstract base class for slider widgets
QwtAbstractSlider is a base class for
slider widgets. It handles mouse events
and updates the slider's value accordingly. Derived classes
only have to implement the getValue() and
getScrollMode() members, and should react to a
valueChange(), which normally requires repainting.
*/
class QWT_EXPORT QwtAbstractSlider : public QWidget, public QwtDoubleRange
{
Q_OBJECT
Q_PROPERTY( bool readOnly READ isReadOnly WRITE setReadOnly )
Q_PROPERTY( bool valid READ isValid WRITE setValid )
Q_PROPERTY( double mass READ mass WRITE setMass )
Q_PROPERTY( Qt::Orientation orientation
READ orientation WRITE setOrientation )
public:
/*!
Scroll mode
\sa getScrollMode()
*/
enum ScrollMode
{
//! Scrolling switched off. Don't change the value.
ScrNone,
/*!
Change the value while the user keeps the
button pressed and moves the mouse.
*/
ScrMouse,
/*!
Automatic scrolling. Increment the value in the specified direction
as long as the user keeps the button pressed.
*/
ScrTimer,
ScrDirect,
//! Automatic scrolling. Same as ScrTimer, but increment by page size.
ScrPage
};
explicit QwtAbstractSlider( Qt::Orientation, QWidget *parent = NULL );
virtual ~QwtAbstractSlider();
void setUpdateTime( int t );
void stopMoving();
void setTracking( bool enable );
virtual void setMass( double val );
virtual double mass() const;
virtual void setOrientation( Qt::Orientation o );
Qt::Orientation orientation() const;
bool isReadOnly() const;
/*
Wrappers for QwtDblRange::isValid/QwtDblRange::setValid made
to be available as Q_PROPERTY in the designer.
*/
/*!
\sa QwtDblRange::isValid()
*/
bool isValid() const
{
return QwtDoubleRange::isValid();
}
/*!
\param valid true/false
\sa QwtDblRange::isValid()
*/
void setValid( bool valid )
{
QwtDoubleRange::setValid( valid );
}
public Q_SLOTS:
virtual void setValue( double val );
virtual void fitValue( double val );
virtual void incValue( int steps );
virtual void setReadOnly( bool );
Q_SIGNALS:
/*!
\brief Notify a change of value.
In the default setting
(tracking enabled), this signal will be emitted every
time the value changes ( see setTracking() ).
\param value new value
*/
void valueChanged( double value );
/*!
This signal is emitted when the user presses the
movable part of the slider (start ScrMouse Mode).
*/
void sliderPressed();
/*!
This signal is emitted when the user releases the
movable part of the slider.
*/
void sliderReleased();
/*!
This signal is emitted when the user moves the
slider with the mouse.
\param value new value
*/
void sliderMoved( double value );
protected:
virtual void setPosition( const QPoint & );
virtual void valueChange();
virtual void timerEvent( QTimerEvent *e );
virtual void mousePressEvent( QMouseEvent *e );
virtual void mouseReleaseEvent( QMouseEvent *e );
virtual void mouseMoveEvent( QMouseEvent *e );
virtual void keyPressEvent( QKeyEvent *e );
virtual void wheelEvent( QWheelEvent *e );
/*!
\brief Determine the value corresponding to a specified poind
This is an abstract virtual function which is called when
the user presses or releases a mouse button or moves the
mouse. It has to be implemented by the derived class.
\param p point
*/
virtual double getValue( const QPoint & p ) = 0;
/*!
\brief Determine what to do when the user presses a mouse button.
This function is abstract and has to be implemented by derived classes.
It is called on a mousePress event. The derived class can determine
what should happen next in dependence of the position where the mouse
was pressed by returning scrolling mode and direction.
\param pos point where the mouse was pressed
\retval scrollMode The scrolling mode
\retval direction direction: 1, 0, or -1.
*/
virtual void getScrollMode( const QPoint &pos,
ScrollMode &scrollMode, int &direction ) const = 0;
void setMouseOffset( double );
double mouseOffset() const;
int scrollMode() const;
private:
void buttonReleased();
class PrivateData;
PrivateData *d_data;
};
#endif