Q3SpinWidget Class Reference

#include <q3rangecontrol.h>

Inheritance diagram for Q3SpinWidget:

[legend]Collaboration diagram for Q3SpinWidget:

[legend]List of all members.

---

Detailed Description

The Q3SpinWidget class is an internal range control related class.

Definition at line 111 of file q3rangecontrol.h.

Public Types
enum	ButtonSymbols
Public Slots
void	stepUp ()
void	stepDown ()
Signals
void	stepUpPressed ()
void	stepDownPressed ()
Public Member Functions
	Q3SpinWidget (QWidget *parent=0, const char *name=0)
	~Q3SpinWidget ()
void	setEditWidget (QWidget *widget)
QWidget *	editWidget ()
QRect	upRect () const
QRect	downRect () const
void	setUpEnabled (bool on)
void	setDownEnabled (bool on)
bool	isUpEnabled () const
bool	isDownEnabled () const
virtual void	setButtonSymbols (ButtonSymbols bs)
ButtonSymbols	buttonSymbols () const
void	arrange ()
Protected Member Functions
void	mousePressEvent (QMouseEvent *e)
void	resizeEvent (QResizeEvent *ev)
void	mouseReleaseEvent (QMouseEvent *e)
void	mouseMoveEvent (QMouseEvent *e)
void	wheelEvent (QWheelEvent *)
void	changeEvent (QEvent *)
void	paintEvent (QPaintEvent *)
Private Slots
void	timerDone ()
void	timerDoneEx ()
Private Member Functions
void	updateDisplay ()
Private Attributes
Q3SpinWidgetPrivate *	d

---

Member Enumeration Documentation

enum Q3SpinWidget::ButtonSymbols

Definition at line 130 of file q3rangecontrol.h.

{ UpDownArrows, PlusMinus };

---

Constructor & Destructor Documentation

Q3SpinWidget::Q3SpinWidget	(	QWidget *	parent = 0,
		const char *	name = 0
	)

Definition at line 73 of file q3spinwidget.cpp.

References arrange(), Q3SpinWidgetPrivate::auRepTimer, QObject::connect(), d, QWidget::setFocusPolicy(), SIGNAL, SLOT, Qt::StrongFocus, timerDone(), and updateDisplay().

    : QWidget(parent, name)
{
    d = new Q3SpinWidgetPrivate();
    connect(&d->auRepTimer, SIGNAL(timeout()), this, SLOT(timerDone()));
    setFocusPolicy(Qt::StrongFocus);

    arrange();
    updateDisplay();
}

Here is the call graph for this function:

Q3SpinWidget::~Q3SpinWidget

(

)

Destroys the object and frees any allocated resources.

Definition at line 89 of file q3spinwidget.cpp.

References d.

{
    delete d;
}

---

Member Function Documentation

void Q3SpinWidget::setEditWidget

(

QWidget *

w

)

Sets the editing widget to w.

Definition at line 103 of file q3spinwidget.cpp.

References arrange(), d, Q3SpinWidgetPrivate::ed, QWidget::setFocusProxy(), updateDisplay(), and w.

Referenced by Q3DateEdit::init(), and Q3TimeEdit::init().

{
    if (w) {
        if (w->parentWidget() != this)
            w->setParent(this);
        setFocusProxy(w);
    }
    d->ed = w;
    arrange();
    updateDisplay();
}

Here is the call graph for this function:

QWidget * Q3SpinWidget::editWidget

(

)

Definition at line 95 of file q3spinwidget.cpp.

References d, and Q3SpinWidgetPrivate::ed.

{
    return d->ed;
}

QRect Q3SpinWidget::upRect

(

)

const

Definition at line 360 of file q3spinwidget.cpp.

References d, and Q3SpinWidgetPrivate::up.

Referenced by Q3TimeEdit::sizeHint(), and Q3DateEdit::sizeHint().

{
    return d->up;
}

QRect Q3SpinWidget::downRect

(

)

const

Definition at line 368 of file q3spinwidget.cpp.

References d, and Q3SpinWidgetPrivate::down.

{
    return d->down;
}

void Q3SpinWidget::setUpEnabled

(

bool

on

)

Sets up-enabled to on.

Definition at line 398 of file q3spinwidget.cpp.

References d, updateDisplay(), and Q3SpinWidgetPrivate::upEnabled.

Referenced by Q3DateEdit::updateButtons(), and Q3TimeEdit::updateButtons().

{
    if ((bool)d->upEnabled != on) {
        d->upEnabled = on;
        updateDisplay();
    }
}

Here is the call graph for this function:

void Q3SpinWidget::setDownEnabled

(

bool

on

)

Sets down-enabled to on.

Definition at line 418 of file q3spinwidget.cpp.

References d, Q3SpinWidgetPrivate::downEnabled, and updateDisplay().

Referenced by Q3DateEdit::updateButtons(), and Q3TimeEdit::updateButtons().

{
    if ((bool)d->downEnabled != on) {
        d->downEnabled = on;
        updateDisplay();
    }
}

Here is the call graph for this function:

bool Q3SpinWidget::isUpEnabled

(

)

const

Definition at line 409 of file q3spinwidget.cpp.

References d, and Q3SpinWidgetPrivate::upEnabled.

Referenced by getStyleOption().

{
    return d->upEnabled;
}

bool Q3SpinWidget::isDownEnabled

(

)

const

Definition at line 429 of file q3spinwidget.cpp.

References d, and Q3SpinWidgetPrivate::downEnabled.

Referenced by getStyleOption().

{
    return d->downEnabled;
}

void Q3SpinWidget::setButtonSymbols

(

ButtonSymbols

bs

)

[virtual]

Sets the button symbol to bs.

Definition at line 438 of file q3spinwidget.cpp.

References Q3SpinWidgetPrivate::bsyms, and d.

{
    d->bsyms = bs;
}

Q3SpinWidget::ButtonSymbols Q3SpinWidget::buttonSymbols

(

)

const

Definition at line 446 of file q3spinwidget.cpp.

References Q3SpinWidgetPrivate::bsyms, and d.

Referenced by getStyleOption().

{
    return d->bsyms;
}

void Q3SpinWidget::arrange

(

)

Definition at line 178 of file q3spinwidget.cpp.

References QStyle::CC_SpinBox, d, Q3SpinWidgetPrivate::down, Q3SpinWidgetPrivate::ed, getStyleOption(), QStyle::SC_SpinBoxDown, QStyle::SC_SpinBoxEditField, QStyle::SC_SpinBoxUp, QWidget::setGeometry(), QWidget::style(), QStyle::subControlRect(), and Q3SpinWidgetPrivate::up.

Referenced by changeEvent(), Q3SpinWidget(), resizeEvent(), and setEditWidget().

{
    QStyleOptionSpinBox opt = getStyleOption(this);
    d->up = style()->subControlRect(QStyle::CC_SpinBox, &opt, QStyle::SC_SpinBoxUp, this);
    d->down = style()->subControlRect(QStyle::CC_SpinBox, &opt, QStyle::SC_SpinBoxDown, this);
    if (d->ed) {
        QRect r = style()->subControlRect(QStyle::CC_SpinBox, &opt,
                                          QStyle::SC_SpinBoxEditField, this);
        d->ed->setGeometry(r);
    }
}

Here is the call graph for this function:

void Q3SpinWidget::stepUpPressed

(

)

[signal]

Referenced by stepUp().

void Q3SpinWidget::stepDownPressed

(

)

[signal]

Referenced by stepDown().

void Q3SpinWidget::stepUp

(

)

[slot]

Definition at line 194 of file q3spinwidget.cpp.

References emit, and stepUpPressed().

Referenced by mousePressEvent(), timerDoneEx(), and wheelEvent().

{
    emit stepUpPressed();
}

void Q3SpinWidget::stepDown

(

)

[slot]

Definition at line 208 of file q3spinwidget.cpp.

References emit, and stepDownPressed().

Referenced by mousePressEvent(), timerDoneEx(), and wheelEvent().

{
    emit stepDownPressed();
}

void Q3SpinWidget::mousePressEvent

(

QMouseEvent *

e

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 119 of file q3spinwidget.cpp.

References QMouseEvent::button(), Q3SpinWidgetPrivate::buttonDown, QRect::contains(), d, Q3SpinWidgetPrivate::down, Q3SpinWidgetPrivate::downEnabled, QEvent::ignore(), Qt::LeftButton, QMouseEvent::pos(), QWidget::repaint(), Q3SpinWidgetPrivate::startTimer(), stepDown(), stepUp(), Q3SpinWidgetPrivate::stopTimer(), Q3SpinWidgetPrivate::theButton, QRect::united(), Q3SpinWidgetPrivate::up, and Q3SpinWidgetPrivate::upEnabled.

{
    if (e->button() != Qt::LeftButton) {
        d->stopTimer();
        d->buttonDown = 0;
        d->theButton = 0;
        repaint(d->down.united(d->up));
        return;
    }

    uint oldButtonDown = d->buttonDown;

    if (d->down.contains(e->pos()) && d->downEnabled)
        d->buttonDown = 1;
    else if (d->up.contains(e->pos()) && d->upEnabled)
        d->buttonDown = 2;
    else
        d->buttonDown = 0;

    d->theButton = d->buttonDown;
    if (oldButtonDown != d->buttonDown) {
        if (!d->buttonDown) {
            repaint(d->down.united(d->up));
        } else if (d->buttonDown & 1) {
            repaint(d->down);
            stepDown();
            d->startTimer(false, 300);
        } else if (d->buttonDown & 2) {
            repaint(d->up);
            stepUp();
            d->startTimer(true, 300);
        }
    }

    if (!oldButtonDown && !d->buttonDown)
        e->ignore();

}

Here is the call graph for this function:

void Q3SpinWidget::resizeEvent

(

QResizeEvent *

ev

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive widget resize events which are passed in the event parameter. When resizeEvent() is called, the widget already has its new geometry. The old size is accessible through QResizeEvent::oldSize().

The widget will be erased and receive a paint event immediately after processing the resize event. No drawing need be (or should be) done inside this handler.

See also:

moveEvent(), event(), resize(), QResizeEvent, paintEvent(), {Scribble Example}

Reimplemented from QWidget.

Definition at line 199 of file q3spinwidget.cpp.

References arrange().

{
    arrange();
}

Here is the call graph for this function:

void Q3SpinWidget::mouseReleaseEvent

(

QMouseEvent *

e

)

[protected, virtual]

The event is passed in e.

Reimplemented from QWidget.

Definition at line 237 of file q3spinwidget.cpp.

References QMouseEvent::button(), Q3SpinWidgetPrivate::buttonDown, d, Q3SpinWidgetPrivate::down, QEvent::ignore(), Qt::LeftButton, QWidget::repaint(), Q3SpinWidgetPrivate::stopTimer(), Q3SpinWidgetPrivate::theButton, and Q3SpinWidgetPrivate::up.

{
    if (e->button() != Qt::LeftButton)
        return;

    uint oldButtonDown = d->theButton;
    d->theButton = 0;
    if (oldButtonDown != d->theButton) {
        if (oldButtonDown & 1)
            repaint(d->down);
        else if (oldButtonDown & 2)
            repaint(d->up);
    }
    d->stopTimer();
    d->buttonDown = 0;

    if (!oldButtonDown && !d->buttonDown)
        e->ignore();
}

Here is the call graph for this function:

void Q3SpinWidget::mouseMoveEvent

(

QMouseEvent *

e

)

[protected, virtual]

The event is passed in e.

Reimplemented from QWidget.

Definition at line 262 of file q3spinwidget.cpp.

References Q3SpinWidgetPrivate::buttonDown, QRect::contains(), d, Q3SpinWidgetPrivate::down, QEvent::ignore(), Qt::LeftButton, QMouseEvent::pos(), QWidget::repaint(), Q3SpinWidgetPrivate::startTimer(), Q3SpinWidgetPrivate::stopTimer(), Q3SpinWidgetPrivate::theButton, and Q3SpinWidgetPrivate::up.

{
    if (!(e->state() & Qt::LeftButton))
        return;

    uint oldButtonDown = d->theButton;
    if (oldButtonDown & 1 && !d->down.contains(e->pos())) {
        d->stopTimer();
        d->theButton = 0;
        repaint(d->down);
    } else if (oldButtonDown & 2 && !d->up.contains(e->pos())) {
        d->stopTimer();
        d->theButton = 0;
        repaint(d->up);
    } else if (!oldButtonDown && d->up.contains(e->pos()) && d->buttonDown & 2) {
        d->startTimer(500);
        d->theButton = 2;
        repaint(d->up);
    } else if (!oldButtonDown && d->down.contains(e->pos()) && d->buttonDown & 1) {
        d->startTimer(500);
        d->theButton = 1;
        repaint(d->down);
    }

    if (!oldButtonDown && !d->buttonDown)
        e->ignore();
}

Here is the call graph for this function:

void Q3SpinWidget::wheelEvent

(

QWheelEvent *

e

)

[protected, virtual]

The event is passed in e.

Reimplemented from QWidget.

Definition at line 295 of file q3spinwidget.cpp.

References QEvent::accept(), QWheelEvent::delta(), i, int, stepDown(), and stepUp().

Referenced by QDateTimeSpinWidget::wheelEvent().

{
    e->accept();
    static float offset = 0;
    static Q3SpinWidget* offset_owner = 0;
    if (offset_owner != this) {
        offset_owner = this;
        offset = 0;
    }
    offset += -e->delta()/120;
    if (QABS(offset) < 1)
        return;
    int ioff = int(offset);
    int i;
    for(i=0; i < QABS(ioff); i++)
        offset > 0 ? stepDown() : stepUp();
    offset -= ioff;
}

Here is the call graph for this function:

void Q3SpinWidget::changeEvent

(

QEvent *

ev

)

[protected, virtual]

The previous style is passed in ev.

Reimplemented from QWidget.

Definition at line 339 of file q3spinwidget.cpp.

References QEvent::ActivationChange, arrange(), Q3SpinWidgetPrivate::buttonDown, QWidget::changeEvent(), d, Q3SpinWidgetPrivate::downEnabled, QEvent::EnabledChange, QWidget::isActiveWindow(), QWidget::isEnabled(), Q3SpinWidgetPrivate::stopTimer(), QEvent::StyleChange, Q3SpinWidgetPrivate::theButton, QEvent::type(), updateDisplay(), and Q3SpinWidgetPrivate::upEnabled.

{
    if(ev->type() == QEvent::StyleChange) {
        arrange();
    } else if(ev->type() == QEvent::ActivationChange) {
        if (!isActiveWindow() && d->buttonDown) {         //was active, but lost focus
            d->stopTimer();
            d->buttonDown = 0;
            d->theButton = 0;
        }
    } else if(ev->type() == QEvent::EnabledChange) {
        d->upEnabled = isEnabled();
        d->downEnabled = isEnabled();
        updateDisplay();
    }
    QWidget::changeEvent(ev);
}

Here is the call graph for this function:

void Q3SpinWidget::paintEvent

(

QPaintEvent *

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive paint events which are passed in the event parameter.

A paint event is a request to repaint all or part of the widget. It can happen as a result of repaint() or update(), or because the widget was obscured and has now been uncovered, or for many other reasons.

Many widgets can simply repaint their entire surface when asked to, but some slow widgets need to optimize by painting only the requested region: QPaintEvent::region(). This speed optimization does not change the result, as painting is clipped to that region during event processing. QListView and QTableView do this, for example.

Qt also tries to speed up painting by merging multiple paint events into one. When update() is called several times or the window system sends several paint events, Qt merges these events into one event with a larger region (see QRegion::united()). repaint() does not permit this optimization, so we suggest using update() whenever possible.

When the paint event occurs, the update region has normally been erased, so that you're painting on the widget's background.

The background can be set using setBackgroundRole() and setPalette().

From Qt 4.0, QWidget automatically double-buffers its painting, so there's no need to write double-buffering code in paintEvent() to avoid flicker.

Note: Under X11 it is possible to toggle the global double buffering by calling qt_x11_set_global_double_buffer(). Example usage:

    ...
    extern void qt_x11_set_global_double_buffer(bool);
    qt_x11_set_global_double_buffer(false);
    ...

See also:

event(), repaint(), update(), QPainter, QPixmap, QPaintEvent, {Analog Clock Example}

Reimplemented from QWidget.

Definition at line 318 of file q3spinwidget.cpp.

References QStyleOptionComplex::activeSubControls, QStyle::CC_SpinBox, d, QStyle::drawComplexControl(), getStyleOption(), p, QStyleOption::rect, QStyle::SC_All, QStyle::SC_None, QStyle::SC_SpinBoxDown, QStyle::SC_SpinBoxFrame, QStyle::SC_SpinBoxUp, QWidget::style(), QStyle::subControlRect(), QStyleOptionComplex::subControls, and Q3SpinWidgetPrivate::theButton.

{
    QPainter p(this);
    QStyleOptionSpinBox opt = getStyleOption(this);

    if (d->theButton & 1)
        opt.activeSubControls = QStyle::SC_SpinBoxDown;
    else if (d->theButton & 2)
        opt.activeSubControls = QStyle::SC_SpinBoxUp;
    else
        opt.activeSubControls = QStyle::SC_None;
    opt.rect = style()->subControlRect(QStyle::CC_SpinBox, &opt, QStyle::SC_SpinBoxFrame, this);
    opt.subControls = QStyle::SC_All;
    style()->drawComplexControl(QStyle::CC_SpinBox, &opt, &p, this);
}

Here is the call graph for this function:

void Q3SpinWidget::timerDone

(

)

[private, slot]

Definition at line 214 of file q3spinwidget.cpp.

References QTimer::singleShot(), SLOT, and timerDoneEx().

Referenced by Q3SpinWidget().

{
    // we use a double timer to make it possible for users to do
    // something with 0-timer on valueChanged.
    QTimer::singleShot(1, this, SLOT(timerDoneEx()));
}

void Q3SpinWidget::timerDoneEx

(

)

[private, slot]

Definition at line 221 of file q3spinwidget.cpp.

References Q3SpinWidgetPrivate::buttonDown, d, Q3SpinWidgetPrivate::startTimer(), stepDown(), stepUp(), and Q3SpinWidgetPrivate::timerUp.

Referenced by timerDone().

{
    if (!d->buttonDown)
        return;
    if (d->timerUp)
        stepUp();
    else
        stepDown();
    d->startTimer(100);
}

void Q3SpinWidget::updateDisplay

(

)

[private]

Definition at line 376 of file q3spinwidget.cpp.

References Q3SpinWidgetPrivate::buttonDown, d, Q3SpinWidgetPrivate::downEnabled, QWidget::isEnabled(), QWidget::repaint(), Q3SpinWidgetPrivate::theButton, and Q3SpinWidgetPrivate::upEnabled.

Referenced by changeEvent(), Q3SpinWidget(), setDownEnabled(), setEditWidget(), and setUpEnabled().

{
    if (!isEnabled()) {
        d->upEnabled = false;
        d->downEnabled = false;
    }
    if (d->theButton & 1 && (d->downEnabled) == 0) {
        d->theButton &= ~1;
        d->buttonDown &= ~1;
    }

    if (d->theButton & 2 && (d->upEnabled) == 0) {
        d->theButton &= ~2;
        d->buttonDown &= ~2;
    }
    repaint();
}

Here is the call graph for this function:

---

Member Data Documentation

Q3SpinWidgetPrivate* Q3SpinWidget::d [private]

Definition at line 160 of file q3rangecontrol.h.

Referenced by arrange(), buttonSymbols(), changeEvent(), downRect(), editWidget(), isDownEnabled(), isUpEnabled(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), paintEvent(), Q3SpinWidget(), setButtonSymbols(), setDownEnabled(), setEditWidget(), setUpEnabled(), timerDoneEx(), updateDisplay(), upRect(), and ~Q3SpinWidget().

---

The documentation for this class was generated from the following files:

• src/qt3support/widgets/q3rangecontrol.h
• src/qt3support/widgets/q3spinwidget.cpp

---