#include "kitemlistcontainer.h"
#include "kitemlistcontroller.h"
+#include "kitemlistsmoothscroller_p.h"
#include "kitemlistview.h"
#include "kitemmodelbase.h"
#include <KDebug>
+/**
+ * Replaces the default viewport of KItemListContainer by a
+ * non-scrollable viewport. The scrolling is done in an optimized
+ * way by KItemListView internally.
+ */
class KItemListContainerViewport : public QGraphicsView
{
public:
- KItemListContainerViewport(QGraphicsScene* scene, QWidget* parent)
- : QGraphicsView(scene, parent)
- {
- setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
- setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
- setViewportMargins(0, 0, 0, 0);
- setFrameShape(QFrame::NoFrame);
- }
-
- void scrollContentsBy(int dx, int dy)
- {
- Q_UNUSED(dx);
- Q_UNUSED(dy);
- // Do nothing. This prevents that e.g. the wheel-event
- // results in a moving of the scene items.
- }
+ KItemListContainerViewport(QGraphicsScene* scene, QWidget* parent);
+protected:
+ virtual void wheelEvent(QWheelEvent* event);
};
+KItemListContainerViewport::KItemListContainerViewport(QGraphicsScene* scene, QWidget* parent) :
+ QGraphicsView(scene, parent)
+{
+ setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
+ setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
+ setViewportMargins(0, 0, 0, 0);
+ setFrameShape(QFrame::NoFrame);
+}
+
+void KItemListContainerViewport::wheelEvent(QWheelEvent* event)
+{
+ // Assure that the wheel-event gets forwarded to the parent
+ // and not handled at all by QGraphicsView.
+ event->ignore();
+}
+
+
+
KItemListContainer::KItemListContainer(KItemListController* controller, QWidget* parent) :
QAbstractScrollArea(parent),
m_controller(controller),
- m_scrollBarPressed(false),
- m_smoothScrolling(false),
- m_smoothScrollingAnimation(0)
+ m_horizontalSmoothScroller(0),
+ m_verticalSmoothScroller(0)
{
Q_ASSERT(controller);
controller->setParent(this);
KItemListContainer::KItemListContainer(QWidget* parent) :
QAbstractScrollArea(parent),
m_controller(0),
- m_scrollBarPressed(false),
- m_smoothScrolling(false),
- m_smoothScrollingAnimation(0)
+ m_horizontalSmoothScroller(0),
+ m_verticalSmoothScroller(0)
{
initialize();
}
void KItemListContainer::scrollContentsBy(int dx, int dy)
{
- KItemListView* view = m_controller->view();
- if (!view) {
- return;
- }
-
- const QScrollBar* scrollBar = (view->scrollOrientation() == Qt::Vertical)
- ? verticalScrollBar() : horizontalScrollBar();
- const qreal currentOffset = view->scrollOffset();
- if (static_cast<int>(currentOffset) == scrollBar->value()) {
- // The current offset is already synchronous to the scrollbar
- return;
- }
-
- qreal offsetDiff = (view->scrollOrientation() == Qt::Vertical) ? dy : dx;
-
- const bool animRunning = (m_smoothScrollingAnimation->state() == QAbstractAnimation::Running);
- if (animRunning) {
- // Stopping a running animation means skipping the range from the current offset
- // until the target offset. To prevent skipping of the range the difference
- // is added to the new target offset.
- const qreal oldEndOffset = m_smoothScrollingAnimation->endValue().toReal();
- offsetDiff += (currentOffset - oldEndOffset);
- }
-
- const qreal endOffset = currentOffset - offsetDiff;
-
- if (m_smoothScrolling || animRunning) {
- qreal startOffset = currentOffset;
- if (animRunning) {
- // If the animation was running and has been interrupted by assigning a new end-offset
- // one frame must be added to the start-offset to keep the animation smooth. This also
- // assures that animation proceeds even in cases where new end-offset are triggered
- // within a very short timeslots.
- startOffset += (endOffset - currentOffset) * 1000 / (m_smoothScrollingAnimation->duration() * 60);
- }
-
- m_smoothScrollingAnimation->stop();
- m_smoothScrollingAnimation->setStartValue(startOffset);
- m_smoothScrollingAnimation->setEndValue(endOffset);
- m_smoothScrollingAnimation->setEasingCurve(animRunning ? QEasingCurve::OutQuad : QEasingCurve::InOutQuad);
- m_smoothScrollingAnimation->start();
- view->setScrollOffset(startOffset);
- } else {
- view->setScrollOffset(endOffset);
- }
-}
-
-bool KItemListContainer::eventFilter(QObject* obj, QEvent* event)
-{
- Q_ASSERT(obj == horizontalScrollBar() || obj == verticalScrollBar());
-
- // Check whether the scrollbar has been adjusted by a mouse-event
- // triggered by the user and remember this in m_scrollBarPressed.
- // The smooth scrolling will only get active if m_scrollBarPressed
- // is true (see scrollContentsBy()).
- const bool scrollVertical = (m_controller->view()->scrollOrientation() == Qt::Vertical);
- const bool checkEvent = ( scrollVertical && obj == verticalScrollBar()) ||
- (!scrollVertical && obj == horizontalScrollBar());
- if (checkEvent) {
- switch (event->type()) {
- case QEvent::MouseButtonPress:
- m_scrollBarPressed = true;
- m_smoothScrolling = true;
- break;
-
- case QEvent::MouseButtonRelease:
- m_scrollBarPressed = false;
- m_smoothScrolling = false;
- break;
-
- case QEvent::Wheel:
- wheelEvent(static_cast<QWheelEvent*>(event));
- break;
-
- default:
- break;
- }
- }
-
- return QAbstractScrollArea::eventFilter(obj, event);
+ m_horizontalSmoothScroller->scrollContentsBy(dx);
+ m_verticalSmoothScroller->scrollContentsBy(dy);
}
void KItemListContainer::wheelEvent(QWheelEvent* event)
}
KItemListView* view = m_controller->view();
-
- if (!view || event->orientation() != view->scrollOrientation()) {
+ if (!view) {
+ event->ignore();
return;
}
+ const bool scrollHorizontally = (event->orientation() == Qt::Horizontal) ||
+ (event->orientation() == Qt::Vertical && !verticalScrollBar()->isVisible());
+ KItemListSmoothScroller* smoothScroller = scrollHorizontally ?
+ m_horizontalSmoothScroller : m_verticalSmoothScroller;
+
const int numDegrees = event->delta() / 8;
const int numSteps = numDegrees / 15;
- const bool previous = m_smoothScrolling;
- m_smoothScrolling = true;
- if (view->scrollOrientation() == Qt::Vertical) {
- const int value = verticalScrollBar()->value();
- verticalScrollBar()->setValue(value - numSteps * view->size().height());
- } else {
- const int value = horizontalScrollBar()->value();
- horizontalScrollBar()->setValue(value - numSteps * view->size().width());
- }
- m_smoothScrolling = previous;
+ const QScrollBar* scrollBar = smoothScroller->scrollBar();
+ smoothScroller->scrollTo(scrollBar->value() - numSteps * scrollBar->pageStep());
event->accept();
}
+void KItemListContainer::slotScrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous)
+{
+ Q_UNUSED(previous);
+ updateSmoothScrollers(current);
+}
+
void KItemListContainer::slotModelChanged(KItemModelBase* current, KItemModelBase* previous)
{
Q_UNUSED(current);
QGraphicsScene* scene = static_cast<QGraphicsView*>(viewport())->scene();
if (previous) {
scene->removeItem(previous);
+ disconnect(current, SIGNAL(scrollOrientationChanged(Qt::Orientation,Qt::Orientation)), this, SLOT(slotScrollOrientationChanged(Qt::Orientation,Qt::Orientation)));
disconnect(previous, SIGNAL(scrollOffsetChanged(qreal,qreal)), this, SLOT(updateScrollOffsetScrollBar()));
disconnect(previous, SIGNAL(maximumScrollOffsetChanged(qreal,qreal)), this, SLOT(updateScrollOffsetScrollBar()));
disconnect(previous, SIGNAL(itemOffsetChanged(qreal,qreal)), this, SLOT(updateItemOffsetScrollBar()));
disconnect(previous, SIGNAL(maximumItemOffsetChanged(qreal,qreal)), this, SLOT(updateItemOffsetScrollBar()));
disconnect(previous, SIGNAL(scrollTo(qreal)), this, SLOT(scrollTo(qreal)));
- m_smoothScrollingAnimation->setTargetObject(0);
+ m_horizontalSmoothScroller->setTargetObject(0);
+ m_verticalSmoothScroller->setTargetObject(0);
}
if (current) {
scene->addItem(current);
+ connect(current, SIGNAL(scrollOrientationChanged(Qt::Orientation,Qt::Orientation)), this, SLOT(slotScrollOrientationChanged(Qt::Orientation,Qt::Orientation)));
connect(current, SIGNAL(scrollOffsetChanged(qreal,qreal)), this, SLOT(updateScrollOffsetScrollBar()));
connect(current, SIGNAL(maximumScrollOffsetChanged(qreal,qreal)), this, SLOT(updateScrollOffsetScrollBar()));
connect(current, SIGNAL(itemOffsetChanged(qreal,qreal)), this, SLOT(updateItemOffsetScrollBar()));
connect(current, SIGNAL(maximumItemOffsetChanged(qreal,qreal)), this, SLOT(updateItemOffsetScrollBar()));
connect(current, SIGNAL(scrollTo(qreal)), this, SLOT(scrollTo(qreal)));
- m_smoothScrollingAnimation->setTargetObject(current);
- }
-}
-
-void KItemListContainer::slotAnimationStateChanged(QAbstractAnimation::State newState,
- QAbstractAnimation::State oldState)
-{
- Q_UNUSED(oldState);
- if (newState == QAbstractAnimation::Stopped && m_smoothScrolling && !m_scrollBarPressed) {
- m_smoothScrolling = false;
+ m_horizontalSmoothScroller->setTargetObject(current);
+ m_verticalSmoothScroller->setTargetObject(current);
+ updateSmoothScrollers(current->scrollOrientation());
}
}
-
void KItemListContainer::scrollTo(qreal offset)
{
const KItemListView* view = m_controller->view();
- if (!view) {
- return;
+ if (view) {
+ if (view->scrollOrientation() == Qt::Vertical) {
+ m_verticalSmoothScroller->scrollTo(offset);
+ } else {
+ m_horizontalSmoothScroller->scrollTo(offset);
+ }
}
-
- m_smoothScrolling = true;
- QScrollBar* scrollBar = (view->scrollOrientation() == Qt::Vertical)
- ? verticalScrollBar() : horizontalScrollBar();
- scrollBar->setValue(offset);
}
void KItemListContainer::updateScrollOffsetScrollBar()
return;
}
+ KItemListSmoothScroller* smoothScroller = 0;
QScrollBar* scrollOffsetScrollBar = 0;
int singleStep = 0;
int pageStep = 0;
if (view->scrollOrientation() == Qt::Vertical) {
+ smoothScroller = m_verticalSmoothScroller;
scrollOffsetScrollBar = verticalScrollBar();
singleStep = view->itemSize().height();
pageStep = view->size().height();
} else {
+ smoothScroller = m_horizontalSmoothScroller;
scrollOffsetScrollBar = horizontalScrollBar();
singleStep = view->itemSize().width();
pageStep = view->size().width();
const int value = view->scrollOffset();
const int maximum = qMax(0, int(view->maximumScrollOffset() - pageStep));
- if (m_smoothScrollingAnimation->state() == QAbstractAnimation::Running) {
- if (maximum == scrollOffsetScrollBar->maximum()) {
- // The value has been changed by the animation, no update
- // of the scrollbars is required as their target state will be
- // reached with the end of the animation.
- return;
- }
-
- // The maximum has been changed which indicates that the content
- // of the view has been changed. Stop the animation in any case and
- // update the scrollbars immediately.
- m_smoothScrollingAnimation->stop();
+ if (smoothScroller->requestScrollBarUpdate(maximum)) {
+ scrollOffsetScrollBar->setSingleStep(singleStep);
+ scrollOffsetScrollBar->setPageStep(pageStep);
+ scrollOffsetScrollBar->setMinimum(0);
+ scrollOffsetScrollBar->setMaximum(maximum);
+ scrollOffsetScrollBar->setValue(value);
}
-
- scrollOffsetScrollBar->setSingleStep(singleStep);
- scrollOffsetScrollBar->setPageStep(pageStep);
- scrollOffsetScrollBar->setMinimum(0);
- scrollOffsetScrollBar->setMaximum(maximum);
- scrollOffsetScrollBar->setValue(value);
}
void KItemListContainer::updateItemOffsetScrollBar()
return;
}
+ KItemListSmoothScroller* smoothScroller = 0;
QScrollBar* itemOffsetScrollBar = 0;
int singleStep = 0;
int pageStep = 0;
if (view->scrollOrientation() == Qt::Vertical) {
+ smoothScroller = m_horizontalSmoothScroller;
itemOffsetScrollBar = horizontalScrollBar();
- singleStep = view->itemSize().width() / 10;
+ singleStep = view->size().width() / 10;
pageStep = view->size().width();
} else {
+ smoothScroller = m_verticalSmoothScroller;
itemOffsetScrollBar = verticalScrollBar();
- singleStep = view->itemSize().height() / 10;
+ singleStep = view->size().height() / 10;
pageStep = view->size().height();
}
const int value = view->itemOffset();
const int maximum = qMax(0, int(view->maximumItemOffset()) - pageStep);
-
- itemOffsetScrollBar->setSingleStep(singleStep);
- itemOffsetScrollBar->setPageStep(pageStep);
- itemOffsetScrollBar->setMinimum(0);
- itemOffsetScrollBar->setMaximum(maximum);
- itemOffsetScrollBar->setValue(value);
+ if (smoothScroller->requestScrollBarUpdate(maximum)) {
+ itemOffsetScrollBar->setSingleStep(singleStep);
+ itemOffsetScrollBar->setPageStep(pageStep);
+ itemOffsetScrollBar->setMinimum(0);
+ itemOffsetScrollBar->setMaximum(maximum);
+ itemOffsetScrollBar->setValue(value);
+ }
}
void KItemListContainer::updateGeometries()
}
}
+void KItemListContainer::updateSmoothScrollers(Qt::Orientation orientation)
+{
+ if (orientation == Qt::Vertical) {
+ m_verticalSmoothScroller->setPropertyName("scrollOffset");
+ m_horizontalSmoothScroller->setPropertyName("itemOffset");
+ } else {
+ m_horizontalSmoothScroller->setPropertyName("scrollOffset");
+ m_verticalSmoothScroller->setPropertyName("itemOffset");
+ }
+}
+
void KItemListContainer::initialize()
{
if (!m_controller) {
QGraphicsView* graphicsView = new KItemListContainerViewport(new QGraphicsScene(this), this);
setViewport(graphicsView);
- m_smoothScrollingAnimation = new QPropertyAnimation(this, "scrollOffset");
- m_smoothScrollingAnimation->setDuration(300);
- connect(m_smoothScrollingAnimation, SIGNAL(stateChanged(QAbstractAnimation::State,QAbstractAnimation::State)),
- this, SLOT(slotAnimationStateChanged(QAbstractAnimation::State,QAbstractAnimation::State)));
-
- horizontalScrollBar()->installEventFilter(this);
- verticalScrollBar()->installEventFilter(this);
+ m_horizontalSmoothScroller = new KItemListSmoothScroller(horizontalScrollBar(), this);
+ m_verticalSmoothScroller = new KItemListSmoothScroller(verticalScrollBar(), this);
}
#include "kitemlistcontainer.moc"
--- /dev/null
+/***************************************************************************
+ * Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com> *
+ * *
+ * This program is free software; you can redistribute it and/or modify *
+ * it under the terms of the GNU General Public License as published by *
+ * the Free Software Foundation; either version 2 of the License, or *
+ * (at your option) any later version. *
+ * *
+ * This program is distributed in the hope that it will be useful, *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
+ * GNU General Public License for more details. *
+ * *
+ * You should have received a copy of the GNU General Public License *
+ * along with this program; if not, write to the *
+ * Free Software Foundation, Inc., *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
+ ***************************************************************************/
+
+#include "kitemlistsmoothscroller_p.h"
+
+#include <QEvent>
+#include <QPropertyAnimation>
+#include <QScrollBar>
+#include <QWheelEvent>
+
+#include <KDebug>
+
+KItemListSmoothScroller::KItemListSmoothScroller(QScrollBar* scrollBar,
+ QObject* parent) :
+ QObject(parent),
+ m_scrollBarPressed(false),
+ m_smoothScrolling(true),
+ m_scrollBar(scrollBar),
+ m_animation(0)
+{
+ m_animation = new QPropertyAnimation(this);
+ m_animation->setDuration(300);
+ connect(m_animation, SIGNAL(stateChanged(QAbstractAnimation::State,QAbstractAnimation::State)),
+ this, SLOT(slotAnimationStateChanged(QAbstractAnimation::State,QAbstractAnimation::State)));
+
+ m_scrollBar->installEventFilter(this);
+}
+
+KItemListSmoothScroller::~KItemListSmoothScroller()
+{
+}
+
+void KItemListSmoothScroller::setScrollBar(QScrollBar *scrollBar)
+{
+ m_scrollBar = scrollBar;
+}
+
+QScrollBar* KItemListSmoothScroller::scrollBar() const
+{
+ return m_scrollBar;
+}
+
+void KItemListSmoothScroller::setTargetObject(QObject* target)
+{
+ m_animation->setTargetObject(target);
+}
+
+QObject* KItemListSmoothScroller::targetObject() const
+{
+ return m_animation->targetObject();
+}
+
+void KItemListSmoothScroller::setPropertyName(const QByteArray& propertyName)
+{
+ m_animation->setPropertyName(propertyName);
+}
+
+QByteArray KItemListSmoothScroller::propertyName() const
+{
+ return m_animation->propertyName();
+}
+
+void KItemListSmoothScroller::scrollContentsBy(qreal distance)
+{
+ QObject* target = targetObject();
+ if (!target) {
+ return;
+ }
+
+ const QByteArray name = propertyName();
+ const qreal currentOffset = target->property(name).toReal();
+ if (static_cast<int>(currentOffset) == m_scrollBar->value()) {
+ // The current offset is already synchronous to the scrollbar
+ return;
+ }
+
+ const bool animRunning = (m_animation->state() == QAbstractAnimation::Running);
+ if (animRunning) {
+ // Stopping a running animation means skipping the range from the current offset
+ // until the target offset. To prevent skipping of the range the difference
+ // is added to the new target offset.
+ const qreal oldEndOffset = m_animation->endValue().toReal();
+ distance += (currentOffset - oldEndOffset);
+ }
+
+ const qreal endOffset = currentOffset - distance;
+
+ if (m_smoothScrolling || animRunning) {
+ qreal startOffset = currentOffset;
+ if (animRunning) {
+ // If the animation was running and has been interrupted by assigning a new end-offset
+ // one frame must be added to the start-offset to keep the animation smooth. This also
+ // assures that animation proceeds even in cases where new end-offset are triggered
+ // within a very short timeslots.
+ startOffset += (endOffset - currentOffset) * 1000 / (m_animation->duration() * 60);
+ }
+
+ m_animation->stop();
+ m_animation->setStartValue(startOffset);
+ m_animation->setEndValue(endOffset);
+ m_animation->setEasingCurve(animRunning ? QEasingCurve::OutQuad : QEasingCurve::InOutQuad);
+ m_animation->start();
+ target->setProperty(name, startOffset);
+ } else {
+ target->setProperty(name, endOffset);
+ }
+}
+
+void KItemListSmoothScroller::scrollTo(qreal position)
+{
+ m_smoothScrolling = true;
+ m_scrollBar->setValue(position);
+}
+
+bool KItemListSmoothScroller::requestScrollBarUpdate(int newMaximum)
+{
+ if (m_animation->state() == QAbstractAnimation::Running) {
+ if (newMaximum == m_scrollBar->maximum()) {
+ // The value has been changed by the animation, no update
+ // of the scrollbars is required as their target state will be
+ // reached with the end of the animation.
+ return false;
+ }
+
+ // The maximum has been changed which indicates that the content
+ // of the view has been changed. Stop the animation in any case and
+ // update the scrollbars immediately.
+ m_animation->stop();
+ }
+ return true;
+}
+
+bool KItemListSmoothScroller::eventFilter(QObject* obj, QEvent* event)
+{
+ Q_ASSERT(obj == m_scrollBar);
+
+ switch (event->type()) {
+ case QEvent::MouseButtonPress:
+ m_scrollBarPressed = true;
+ m_smoothScrolling = true;
+ break;
+
+ case QEvent::MouseButtonRelease:
+ m_scrollBarPressed = false;
+ m_smoothScrolling = false;
+ break;
+
+ case QEvent::Wheel:
+ handleWheelEvent(static_cast<QWheelEvent*>(event));
+ break;
+
+ default:
+ break;
+ }
+
+ return QObject::eventFilter(obj, event);
+}
+
+void KItemListSmoothScroller::slotAnimationStateChanged(QAbstractAnimation::State newState,
+ QAbstractAnimation::State oldState)
+{
+ Q_UNUSED(oldState);
+ if (newState == QAbstractAnimation::Stopped && m_smoothScrolling && !m_scrollBarPressed) {
+ m_smoothScrolling = false;
+ }
+}
+
+void KItemListSmoothScroller::handleWheelEvent(QWheelEvent* event)
+{
+ const int numDegrees = event->delta() / 8;
+ const int numSteps = numDegrees / 15;
+
+ const bool previous = m_smoothScrolling;
+
+ m_smoothScrolling = true;
+ const int value = m_scrollBar->value();
+ const int pageStep = m_scrollBar->pageStep();
+ m_scrollBar->setValue(value - numSteps * pageStep);
+
+ m_smoothScrolling = previous;
+
+ event->accept();
+}
+
+#include "kitemlistsmoothscroller_p.moc"
--- /dev/null
+/***************************************************************************
+ * Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com> *
+ * *
+ * This program is free software; you can redistribute it and/or modify *
+ * it under the terms of the GNU General Public License as published by *
+ * the Free Software Foundation; either version 2 of the License, or *
+ * (at your option) any later version. *
+ * *
+ * This program is distributed in the hope that it will be useful, *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
+ * GNU General Public License for more details. *
+ * *
+ * You should have received a copy of the GNU General Public License *
+ * along with this program; if not, write to the *
+ * Free Software Foundation, Inc., *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
+ ***************************************************************************/
+
+#ifndef KITEMLISTSMOOTHSCROLLER_H
+#define KITEMLISTSMOOTHSCROLLER_H
+
+#include <libdolphin_export.h>
+
+#include <QAbstractAnimation>
+#include <QObject>
+
+class QPropertyAnimation;
+class QScrollBar;
+class QWheelEvent;
+
+/**
+ * @brief Helper class for KItemListContainer to have a smooth
+ * scrolling when adjusting the scrollbars.
+ */
+class LIBDOLPHINPRIVATE_EXPORT KItemListSmoothScroller : public QObject
+{
+ Q_OBJECT
+
+public:
+ KItemListSmoothScroller(QScrollBar* scrollBar,
+ QObject* parent = 0);
+ virtual ~KItemListSmoothScroller();
+
+ void setScrollBar(QScrollBar* scrollBar);
+ QScrollBar* scrollBar() const;
+
+ void setTargetObject(QObject* target);
+ QObject* targetObject() const;
+
+ void setPropertyName(const QByteArray& propertyName);
+ QByteArray propertyName() const;
+
+ /**
+ * Adjusts the position of the target by \p distance
+ * pixels. Is invoked in the context of QAbstractScrollArea::scrollContentsBy()
+ * where the scrollbars already have the new position but the content
+ * has not been scrolled yet.
+ */
+ void scrollContentsBy(qreal distance);
+
+ /**
+ * Does a smooth-scrolling to the position \p position
+ * on the target and also adjusts the corresponding scrollbar
+ * to the new position.
+ */
+ void scrollTo(qreal position);
+
+ /**
+ * Must be invoked before the scrollbar should get updated to have a new
+ * maximum. True is returned if the new maximum can be applied. If false
+ * is returned the maximum has already been reached and the value will
+ * be reached at the end of the animation.
+ */
+ // TODO: This interface is tricky to understand. Try to make this more
+ // generic/readable if the corresponding code in KItemListContainer got
+ // stable.
+ bool requestScrollBarUpdate(int newMaximum);
+
+protected:
+ virtual bool eventFilter(QObject* obj, QEvent* event);
+
+private slots:
+ void slotAnimationStateChanged(QAbstractAnimation::State newState,
+ QAbstractAnimation::State oldState);
+
+private:
+ /**
+ * Results into a smooth-scrolling of the target dependent on the direction
+ * of the wheel event.
+ */
+ void handleWheelEvent(QWheelEvent* event);
+
+private:
+ bool m_scrollBarPressed;
+ bool m_smoothScrolling;
+ QScrollBar* m_scrollBar;
+ QPropertyAnimation* m_animation;
+};
+
+#endif
+
+