diff options
Diffstat (limited to 'src/gui/widgets/qdial.cpp')
| -rw-r--r-- | src/gui/widgets/qdial.cpp | 546 |
1 files changed, 0 insertions, 546 deletions
diff --git a/src/gui/widgets/qdial.cpp b/src/gui/widgets/qdial.cpp deleted file mode 100644 index 19e8d231ca..0000000000 --- a/src/gui/widgets/qdial.cpp +++ /dev/null @@ -1,546 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). -** All rights reserved. -** Contact: Nokia Corporation (qt-info@nokia.com) -** -** This file is part of the QtGui module of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:LGPL$ -** No Commercial Usage -** This file contains pre-release code and may not be distributed. -** You may use this file in accordance with the terms and conditions -** contained in the Technology Preview License Agreement accompanying -** this package. -** -** GNU Lesser General Public License Usage -** Alternatively, this file may be used under the terms of the GNU Lesser -** General Public License version 2.1 as published by the Free Software -** Foundation and appearing in the file LICENSE.LGPL included in the -** packaging of this file. Please review the following information to -** ensure the GNU Lesser General Public License version 2.1 requirements -** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. -** -** In addition, as a special exception, Nokia gives you certain additional -** rights. These rights are described in the Nokia Qt LGPL Exception -** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. -** -** If you have questions regarding the use of this file, please contact -** Nokia at qt-info@nokia.com. -** -** -** -** -** -** -** -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -#include "qdial.h" - -#ifndef QT_NO_DIAL - -#include <qapplication.h> -#include <qbitmap.h> -#include <qcolor.h> -#include <qevent.h> -#include <qpainter.h> -#include <qpolygon.h> -#include <qregion.h> -#include <qstyle.h> -#include <qstylepainter.h> -#include <qstyleoption.h> -#include <qslider.h> -#include <private/qabstractslider_p.h> -#include <private/qmath_p.h> -#ifndef QT_NO_ACCESSIBILITY -#include "qaccessible.h" -#endif -#include <qmath.h> - -QT_BEGIN_NAMESPACE - -class QDialPrivate : public QAbstractSliderPrivate -{ - Q_DECLARE_PUBLIC(QDial) -public: - QDialPrivate() - { - wrapping = false; - tracking = true; - doNotEmit = false; - target = qreal(3.7); - } - - qreal target; - uint showNotches : 1; - uint wrapping : 1; - uint doNotEmit : 1; - - int valueFromPoint(const QPoint &) const; - double angle(const QPoint &, const QPoint &) const; - void init(); - virtual int bound(int val) const; -}; - -void QDialPrivate::init() -{ - Q_Q(QDial); - showNotches = false; - q->setFocusPolicy(Qt::WheelFocus); -#ifdef QT3_SUPPORT - QObject::connect(q, SIGNAL(sliderPressed()), q, SIGNAL(dialPressed())); - QObject::connect(q, SIGNAL(sliderMoved(int)), q, SIGNAL(dialMoved(int))); - QObject::connect(q, SIGNAL(sliderReleased()), q, SIGNAL(dialReleased())); -#endif -} - -int QDialPrivate::bound(int val) const -{ - if (wrapping) { - if ((val >= minimum) && (val <= maximum)) - return val; - val = minimum + ((val - minimum) % (maximum - minimum)); - if (val < minimum) - val += maximum - minimum; - return val; - } else { - return QAbstractSliderPrivate::bound(val); - } -} - -/*! - Initialize \a option with the values from this QDial. This method - is useful for subclasses when they need a QStyleOptionSlider, but don't want - to fill in all the information themselves. - - \sa QStyleOption::initFrom() -*/ -void QDial::initStyleOption(QStyleOptionSlider *option) const -{ - if (!option) - return; - - Q_D(const QDial); - option->initFrom(this); - option->minimum = d->minimum; - option->maximum = d->maximum; - option->sliderPosition = d->position; - option->sliderValue = d->value; - option->singleStep = d->singleStep; - option->pageStep = d->pageStep; - option->upsideDown = !d->invertedAppearance; - option->notchTarget = d->target; - option->dialWrapping = d->wrapping; - option->subControls = QStyle::SC_All; - option->activeSubControls = QStyle::SC_None; - if (!d->showNotches) { - option->subControls &= ~QStyle::SC_DialTickmarks; - option->tickPosition = QSlider::TicksAbove; - } else { - option->tickPosition = QSlider::NoTicks; - } - option->tickInterval = notchSize(); -} - -int QDialPrivate::valueFromPoint(const QPoint &p) const -{ - Q_Q(const QDial); - double yy = (double)q->height()/2.0 - p.y(); - double xx = (double)p.x() - q->width()/2.0; - double a = (xx || yy) ? qAtan2(yy, xx) : 0; - - if (a < Q_PI / -2) - a = a + Q_PI * 2; - - int dist = 0; - int minv = minimum, maxv = maximum; - - if (minimum < 0) { - dist = -minimum; - minv = 0; - maxv = maximum + dist; - } - - int r = maxv - minv; - int v; - if (wrapping) - v = (int)(0.5 + minv + r * (Q_PI * 3 / 2 - a) / (2 * Q_PI)); - else - v = (int)(0.5 + minv + r* (Q_PI * 4 / 3 - a) / (Q_PI * 10 / 6)); - - if (dist > 0) - v -= dist; - - return !invertedAppearance ? bound(v) : maximum - bound(v); -} - -/*! - \class QDial - - \brief The QDial class provides a rounded range control (like a speedometer or potentiometer). - - \ingroup basicwidgets - - - QDial is used when the user needs to control a value within a - program-definable range, and the range either wraps around - (for example, with angles measured from 0 to 359 degrees) or the - dialog layout needs a square widget. - - Since QDial inherits from QAbstractSlider, the dial behaves in - a similar way to a \l{QSlider}{slider}. When wrapping() is false - (the default setting) there is no real difference between a slider - and a dial. They both share the same signals, slots and member - functions. Which one you use depends on the expectations of - your users and on the type of application. - - The dial initially emits valueChanged() signals continuously while - the slider is being moved; you can make it emit the signal less - often by disabling the \l{QAbstractSlider::tracking} {tracking} - property. The sliderMoved() signal is emitted continuously even - when tracking is disabled. - - The dial also emits sliderPressed() and sliderReleased() signals - when the mouse button is pressed and released. Note that the - dial's value can change without these signals being emitted since - the keyboard and wheel can also be used to change the value. - - Unlike the slider, QDial attempts to draw a "nice" number of - notches rather than one per line step. If possible, the number of - notches drawn is one per line step, but if there aren't enough pixels - to draw every one, QDial will skip notches to try and draw a uniform - set (e.g. by drawing every second or third notch). - - Like the slider, the dial makes the QAbstractSlider functions - setValue(), addLine(), subtractLine(), addPage() and - subtractPage() available as slots. - - The dial's keyboard interface is fairly simple: The - \key{left}/\key{up} and \key{right}/\key{down} arrow keys adjust - the dial's \l {QAbstractSlider::value} {value} by the defined - \l {QAbstractSlider::singleStep} {singleStep}, \key{Page Up} and - \key{Page Down} by the defined \l {QAbstractSlider::pageStep} - {pageStep}, and the \key Home and \key End keys set the value to - the defined \l {QAbstractSlider::minimum} {minimum} and - \l {QAbstractSlider::maximum} {maximum} values. - - If you are using the mouse wheel to adjust the dial, the increment - value is determined by the lesser value of - \l{QApplication::wheelScrollLines()} {wheelScrollLines} multipled - by \l {QAbstractSlider::singleStep} {singleStep}, and - \l {QAbstractSlider::pageStep} {pageStep}. - - \table - \row \o \inlineimage plastique-dial.png Screenshot of a dial in the Plastique widget style - \o \inlineimage windowsxp-dial.png Screenshot of a dial in the Windows XP widget style - \o \inlineimage macintosh-dial.png Screenshot of a dial in the Macintosh widget style - \row \o {3,1} Dials shown in various widget styles (from left to right): - \l{Plastique Style Widget Gallery}{Plastique}, - \l{Windows XP Style Widget Gallery}{Windows XP}, - \l{Macintosh Style Widget Gallery}{Macintosh}. - \endtable - - \sa QScrollBar, QSpinBox, QSlider, {fowler}{GUI Design Handbook: Slider}, {Sliders Example} -*/ - -/*! - Constructs a dial. - - The \a parent argument is sent to the QAbstractSlider constructor. -*/ -QDial::QDial(QWidget *parent) - : QAbstractSlider(*new QDialPrivate, parent) -{ - Q_D(QDial); - d->init(); -} - -#ifdef QT3_SUPPORT -/*! - Use one of the constructors that doesn't take the \a name - argument and then use setObjectName() instead. -*/ -QDial::QDial(QWidget *parent, const char *name) - : QAbstractSlider(*new QDialPrivate, parent) -{ - Q_D(QDial); - setObjectName(QString::fromAscii(name)); - d->init(); -} - -/*! - Use one of the constructors that doesn't take the \a name - argument and then use setObjectName() instead. -*/ -QDial::QDial(int minValue, int maxValue, int pageStep, int value, - QWidget *parent, const char *name) - : QAbstractSlider(*new QDialPrivate, parent) -{ - Q_D(QDial); - setObjectName(QString::fromAscii(name)); - d->minimum = minValue; - d->maximum = maxValue; - d->pageStep = pageStep; - d->position = d->value = value; - d->init(); -} -#endif -/*! - Destroys the dial. -*/ -QDial::~QDial() -{ -} - -/*! \reimp */ -void QDial::resizeEvent(QResizeEvent *e) -{ - QWidget::resizeEvent(e); -} - -/*! - \reimp -*/ - -void QDial::paintEvent(QPaintEvent *) -{ - QStylePainter p(this); - QStyleOptionSlider option; - initStyleOption(&option); - p.drawComplexControl(QStyle::CC_Dial, option); -} - -/*! - \reimp -*/ - -void QDial::mousePressEvent(QMouseEvent *e) -{ - Q_D(QDial); - if (d->maximum == d->minimum || - (e->button() != Qt::LeftButton) || - (e->buttons() ^ e->button())) { - e->ignore(); - return; - } - e->accept(); - setSliderPosition(d->valueFromPoint(e->pos())); - // ### This isn't quite right, - // we should be doing a hit test and only setting this if it's - // the actual dial thingie (similar to what QSlider does), but we have no - // subControls for QDial. - setSliderDown(true); -} - - -/*! - \reimp -*/ - -void QDial::mouseReleaseEvent(QMouseEvent * e) -{ - Q_D(QDial); - if (e->buttons() & (~e->button()) || - (e->button() != Qt::LeftButton)) { - e->ignore(); - return; - } - e->accept(); - setValue(d->valueFromPoint(e->pos())); - setSliderDown(false); -} - - -/*! - \reimp -*/ - -void QDial::mouseMoveEvent(QMouseEvent * e) -{ - Q_D(QDial); - if (!(e->buttons() & Qt::LeftButton)) { - e->ignore(); - return; - } - e->accept(); - d->doNotEmit = true; - setSliderPosition(d->valueFromPoint(e->pos())); - d->doNotEmit = false; -} - - -/*! - \reimp -*/ - -void QDial::sliderChange(SliderChange change) -{ - QAbstractSlider::sliderChange(change); -} - -void QDial::setWrapping(bool enable) -{ - Q_D(QDial); - if (d->wrapping == enable) - return; - d->wrapping = enable; - update(); -} - - -/*! - \property QDial::wrapping - \brief whether wrapping is enabled - - If true, wrapping is enabled; otherwise some space is inserted at the bottom - of the dial to separate the ends of the range of valid values. - - If enabled, the arrow can be oriented at any angle on the dial. If disabled, - the arrow will be restricted to the upper part of the dial; if it is rotated - into the space at the bottom of the dial, it will be clamped to the closest - end of the valid range of values. - - By default this property is false. -*/ - -bool QDial::wrapping() const -{ - Q_D(const QDial); - return d->wrapping; -} - - -/*! - \property QDial::notchSize - \brief the current notch size - - The notch size is in range control units, not pixels, and if - possible it is a multiple of singleStep() that results in an - on-screen notch size near notchTarget(). - - By default, this property has a value of 1. - - \sa notchTarget(), singleStep() -*/ - -int QDial::notchSize() const -{ - Q_D(const QDial); - // radius of the arc - int r = qMin(width(), height())/2; - // length of the whole arc - int l = (int)(r * (d->wrapping ? 6 : 5) * Q_PI / 6); - // length of the arc from minValue() to minValue()+pageStep() - if (d->maximum > d->minimum + d->pageStep) - l = (int)(0.5 + l * d->pageStep / (d->maximum - d->minimum)); - // length of a singleStep arc - l = l * d->singleStep / (d->pageStep ? d->pageStep : 1); - if (l < 1) - l = 1; - // how many times singleStep can be draw in d->target pixels - l = (int)(0.5 + d->target / l); - // we want notchSize() to be a non-zero multiple of lineStep() - if (!l) - l = 1; - return d->singleStep * l; -} - -void QDial::setNotchTarget(double target) -{ - Q_D(QDial); - d->target = target; - update(); -} - -/*! - \property QDial::notchTarget - \brief the target number of pixels between notches - - The notch target is the number of pixels QDial attempts to put - between each notch. - - The actual size may differ from the target size. - - The default notch target is 3.7 pixels. -*/ -qreal QDial::notchTarget() const -{ - Q_D(const QDial); - return d->target; -} - - -void QDial::setNotchesVisible(bool visible) -{ - Q_D(QDial); - d->showNotches = visible; - update(); -} - -/*! - \property QDial::notchesVisible - \brief whether the notches are shown - - If the property is true, a series of notches are drawn around the dial - to indicate the range of values available; otherwise no notches are - shown. - - By default, this property is disabled. -*/ -bool QDial::notchesVisible() const -{ - Q_D(const QDial); - return d->showNotches; -} - -/*! - \reimp -*/ - -QSize QDial::minimumSizeHint() const -{ - return QSize(50, 50); -} - -/*! - \reimp -*/ - -QSize QDial::sizeHint() const -{ - return QSize(100, 100).expandedTo(QApplication::globalStrut()); -} - -/*! - \reimp -*/ -bool QDial::event(QEvent *e) -{ - return QAbstractSlider::event(e); -} - -/*! - \fn void QDial::dialPressed(); - - Use QAbstractSlider::sliderPressed() instead. -*/ - -/*! - \fn void QDial::dialMoved(int value); - - Use QAbstractSlider::sliderMoved() instead. -*/ - -/*! - \fn void QDial::dialReleased(); - - Use QAbstractSlider::sliderReleased() instead. -*/ - -QT_END_NAMESPACE - -#endif // QT_NO_DIAL |