-/***************************************************************************
- * Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com> *
- * *
- * Based on the Itemviews NG project from Trolltech Labs: *
- * http://qt.gitorious.org/qt-labs/itemviews-ng *
- * *
- * 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 *
- ***************************************************************************/
+/*
+ * SPDX-FileCopyrightText: 2011 Peter Penz <peter.penz19@gmail.com>
+ *
+ * Based on the Itemviews NG project from Trolltech Labs
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later
+ */
#include "kitemlistcontainer.h"
#include "kitemlistcontroller.h"
#include "kitemlistview.h"
-#include "kitemmodelbase.h"
-
#include "private/kitemlistsmoothscroller.h"
+#ifndef QT_NO_ACCESSIBILITY
+#include <QAccessibleEvent>
+#endif
#include <QApplication>
+#include <QFontMetrics>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QScrollBar>
-#include <QStyle>
+#include <QScroller>
#include <QStyleOption>
-#include <KDebug>
-
/**
* Replaces the default viewport of KItemListContainer by a
* non-scrollable viewport. The scrolling is done in an optimized
*/
class KItemListContainerViewport : public QGraphicsView
{
+ Q_OBJECT
+
public:
- KItemListContainerViewport(QGraphicsScene* scene, QWidget* parent);
+ KItemListContainerViewport(QGraphicsScene *scene, QWidget *parent);
+
protected:
- virtual void wheelEvent(QWheelEvent* event);
+ void wheelEvent(QWheelEvent *event) override;
};
-KItemListContainerViewport::KItemListContainerViewport(QGraphicsScene* scene, QWidget* parent) :
- QGraphicsView(scene, parent)
+KItemListContainerViewport::KItemListContainerViewport(QGraphicsScene *scene, QWidget *parent)
+ : QGraphicsView(scene, parent)
{
setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
setFrameShape(QFrame::NoFrame);
}
-void KItemListContainerViewport::wheelEvent(QWheelEvent* event)
+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_horizontalSmoothScroller(0),
- m_verticalSmoothScroller(0)
+KItemListContainer::KItemListContainer(KItemListController *controller, QWidget *parent)
+ : QAbstractScrollArea(parent)
+ , m_controller(controller)
+ , m_horizontalSmoothScroller(nullptr)
+ , m_verticalSmoothScroller(nullptr)
+ , m_scroller(nullptr)
{
Q_ASSERT(controller);
controller->setParent(this);
- QGraphicsView* graphicsView = new KItemListContainerViewport(new QGraphicsScene(this), this);
+ QGraphicsView *graphicsView = new KItemListContainerViewport(new QGraphicsScene(this), this);
setViewport(graphicsView);
m_horizontalSmoothScroller = new KItemListSmoothScroller(horizontalScrollBar(), this);
m_verticalSmoothScroller = new KItemListSmoothScroller(verticalScrollBar(), this);
if (controller->model()) {
- slotModelChanged(controller->model(), 0);
+ slotModelChanged(controller->model(), nullptr);
}
if (controller->view()) {
- slotViewChanged(controller->view(), 0);
+ slotViewChanged(controller->view(), nullptr);
}
- connect(controller, &KItemListController::modelChanged,
- this, &KItemListContainer::slotModelChanged);
- connect(controller, &KItemListController::viewChanged,
- this, &KItemListContainer::slotViewChanged);
+ connect(controller, &KItemListController::modelChanged, this, &KItemListContainer::slotModelChanged);
+ connect(controller, &KItemListController::viewChanged, this, &KItemListContainer::slotViewChanged);
+
+ m_scroller = QScroller::scroller(viewport());
+ m_scroller->grabGesture(viewport());
+ connect(controller, &KItemListController::scrollerStop, this, &KItemListContainer::stopScroller);
+ connect(m_scroller, &QScroller::stateChanged, controller, &KItemListController::slotStateChanged);
}
KItemListContainer::~KItemListContainer()
// Don't rely on the QObject-order to delete the controller, otherwise
// the QGraphicsScene might get deleted before the view.
delete m_controller;
- m_controller = 0;
+ m_controller = nullptr;
}
-KItemListController* KItemListContainer::controller() const
+KItemListController *KItemListContainer::controller() const
{
return m_controller;
}
void KItemListContainer::setEnabledFrame(bool enable)
{
- QGraphicsView* graphicsView = qobject_cast<QGraphicsView*>(viewport());
+ QGraphicsView *graphicsView = qobject_cast<QGraphicsView *>(viewport());
if (enable) {
setFrameShape(QFrame::StyledPanel);
graphicsView->setPalette(palette());
// to the text color, so that enough contrast is given for all color
// schemes
QPalette p = graphicsView->palette();
- p.setColor(QPalette::Active, QPalette::Text, p.color(QPalette::Active, QPalette::WindowText));
+ p.setColor(QPalette::Active, QPalette::Text, p.color(QPalette::Active, QPalette::WindowText));
p.setColor(QPalette::Inactive, QPalette::Text, p.color(QPalette::Inactive, QPalette::WindowText));
p.setColor(QPalette::Disabled, QPalette::Text, p.color(QPalette::Disabled, QPalette::WindowText));
graphicsView->setPalette(p);
bool KItemListContainer::enabledFrame() const
{
- const QGraphicsView* graphicsView = qobject_cast<QGraphicsView*>(viewport());
+ const QGraphicsView *graphicsView = qobject_cast<QGraphicsView *>(viewport());
return graphicsView->autoFillBackground();
}
-void KItemListContainer::keyPressEvent(QKeyEvent* event)
+void KItemListContainer::keyPressEvent(QKeyEvent *event)
{
// TODO: We should find a better way to handle the key press events in the view.
// The reasons why we need this hack are:
// 2. By default, the KItemListView does not have the keyboard focus in the QGraphicsScene, so
// simply sending the event to the QGraphicsView which is the KItemListContainer's viewport
// does not work.
- KItemListView* view = m_controller->view();
+ KItemListView *view = m_controller->view();
+ if (view) {
+ QApplication::sendEvent(view, event);
+ }
+}
+
+void KItemListContainer::contextMenuEvent(QContextMenuEvent *event)
+{
+ // Note copied from the keyPressEvent() method above because the same reasons probably also apply here.
+ // TODO: We should find a better way to handle the context menu events in the view.
+ // The reasons why we need this hack are:
+ // 1. Without reimplementing contextMenuEvent() here, the event would not reach the QGraphicsView.
+ // 2. By default, the KItemListView does not have the keyboard focus in the QGraphicsScene, so
+ // simply sending the event to the QGraphicsView which is the KItemListContainer's viewport
+ // does not work.
+ KItemListView *view = m_controller->view();
if (view) {
QApplication::sendEvent(view, event);
}
}
-void KItemListContainer::showEvent(QShowEvent* event)
+void KItemListContainer::showEvent(QShowEvent *event)
{
QAbstractScrollArea::showEvent(event);
updateGeometries();
}
-void KItemListContainer::resizeEvent(QResizeEvent* event)
+void KItemListContainer::resizeEvent(QResizeEvent *event)
{
QAbstractScrollArea::resizeEvent(event);
updateGeometries();
m_verticalSmoothScroller->scrollContentsBy(dy);
}
-void KItemListContainer::wheelEvent(QWheelEvent* event)
+void KItemListContainer::wheelEvent(QWheelEvent *event)
{
if (event->modifiers().testFlag(Qt::ControlModifier)) {
event->ignore();
return;
}
- KItemListView* view = m_controller->view();
+ KItemListView *view = m_controller->view();
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 bool scrollHorizontally = (qAbs(event->angleDelta().y()) < qAbs(event->angleDelta().x())) || (!verticalScrollBar()->isVisible());
+ KItemListSmoothScroller *smoothScroller = scrollHorizontally ? m_horizontalSmoothScroller : m_verticalSmoothScroller;
- const QScrollBar* scrollBar = smoothScroller->scrollBar();
- if (!event->pixelDelta().isNull()) {
- const int numPixels = event->pixelDelta().y();
- smoothScroller->scrollTo(scrollBar->value() - numPixels);
- } else {
- const int numDegrees = event->angleDelta().y() / 8;
- const int numSteps = numDegrees / 15;
- smoothScroller->scrollTo(scrollBar->value() - numSteps * scrollBar->pageStep() / 4);
+ smoothScroller->handleWheelEvent(event);
+}
+
+void KItemListContainer::focusInEvent(QFocusEvent *event)
+{
+ KItemListView *view = m_controller->view();
+ if (view) {
+ QApplication::sendEvent(view, event);
+
+ // We need to set the focus to the view or accessibility software will only announce the container (which has no information available itself).
+ // For some reason actively setting the focus to the view needs to be delayed or the focus will immediately go back to this container.
+ QTimer::singleShot(0, this, [this, view]() {
+ view->setFocus();
+#ifndef QT_NO_ACCESSIBILITY
+ QAccessibleEvent accessibleFocusInEvent(this, QAccessible::Focus);
+ accessibleFocusInEvent.setChild(0);
+ QAccessible::updateAccessibility(&accessibleFocusInEvent);
+#endif
+ });
}
+}
- event->accept();
+void KItemListContainer::focusOutEvent(QFocusEvent *event)
+{
+ KItemListView *view = m_controller->view();
+ if (view) {
+ QApplication::sendEvent(view, event);
+ }
}
void KItemListContainer::slotScrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous)
{
- Q_UNUSED(previous);
+ Q_UNUSED(previous)
updateSmoothScrollers(current);
}
-void KItemListContainer::slotModelChanged(KItemModelBase* current, KItemModelBase* previous)
+void KItemListContainer::slotModelChanged(KItemModelBase *current, KItemModelBase *previous)
{
- Q_UNUSED(current);
- Q_UNUSED(previous);
+ Q_UNUSED(current)
+ Q_UNUSED(previous)
}
-void KItemListContainer::slotViewChanged(KItemListView* current, KItemListView* previous)
+void KItemListContainer::slotViewChanged(KItemListView *current, KItemListView *previous)
{
- QGraphicsScene* scene = static_cast<QGraphicsView*>(viewport())->scene();
+ QGraphicsScene *scene = static_cast<QGraphicsView *>(viewport())->scene();
if (previous) {
scene->removeItem(previous);
- disconnect(previous, &KItemListView::scrollOrientationChanged,
- this, &KItemListContainer::slotScrollOrientationChanged);
- disconnect(previous, &KItemListView::scrollOffsetChanged,
- this, &KItemListContainer::updateScrollOffsetScrollBar);
- disconnect(previous, &KItemListView::maximumScrollOffsetChanged,
- this, &KItemListContainer::updateScrollOffsetScrollBar);
- disconnect(previous, &KItemListView::itemOffsetChanged,
- this, &KItemListContainer::updateItemOffsetScrollBar);
- disconnect(previous, &KItemListView::maximumItemOffsetChanged,
- this, &KItemListContainer::updateItemOffsetScrollBar);
+ disconnect(previous, &KItemListView::scrollOrientationChanged, this, &KItemListContainer::slotScrollOrientationChanged);
+ disconnect(previous, &KItemListView::scrollOffsetChanged, this, &KItemListContainer::updateScrollOffsetScrollBar);
+ disconnect(previous, &KItemListView::maximumScrollOffsetChanged, this, &KItemListContainer::updateScrollOffsetScrollBar);
+ disconnect(previous, &KItemListView::itemOffsetChanged, this, &KItemListContainer::updateItemOffsetScrollBar);
+ disconnect(previous, &KItemListView::maximumItemOffsetChanged, this, &KItemListContainer::updateItemOffsetScrollBar);
disconnect(previous, &KItemListView::scrollTo, this, &KItemListContainer::scrollTo);
- m_horizontalSmoothScroller->setTargetObject(0);
- m_verticalSmoothScroller->setTargetObject(0);
+ disconnect(m_horizontalSmoothScroller, &KItemListSmoothScroller::scrollingStopped, previous, &KItemListView::scrollingStopped);
+ disconnect(m_verticalSmoothScroller, &KItemListSmoothScroller::scrollingStopped, previous, &KItemListView::scrollingStopped);
+ m_horizontalSmoothScroller->setTargetObject(nullptr);
+ m_verticalSmoothScroller->setTargetObject(nullptr);
}
if (current) {
scene->addItem(current);
- connect(current, &KItemListView::scrollOrientationChanged,
- this, &KItemListContainer::slotScrollOrientationChanged);
- connect(current, &KItemListView::scrollOffsetChanged,
- this, &KItemListContainer::updateScrollOffsetScrollBar);
- connect(current, &KItemListView::maximumScrollOffsetChanged,
- this, &KItemListContainer::updateScrollOffsetScrollBar);
- connect(current, &KItemListView::itemOffsetChanged,
- this, &KItemListContainer::updateItemOffsetScrollBar);
- connect(current, &KItemListView::maximumItemOffsetChanged,
- this, &KItemListContainer::updateItemOffsetScrollBar);
+ connect(current, &KItemListView::scrollOrientationChanged, this, &KItemListContainer::slotScrollOrientationChanged);
+ connect(current, &KItemListView::scrollOffsetChanged, this, &KItemListContainer::updateScrollOffsetScrollBar);
+ connect(current, &KItemListView::maximumScrollOffsetChanged, this, &KItemListContainer::updateScrollOffsetScrollBar);
+ connect(current, &KItemListView::itemOffsetChanged, this, &KItemListContainer::updateItemOffsetScrollBar);
+ connect(current, &KItemListView::maximumItemOffsetChanged, this, &KItemListContainer::updateItemOffsetScrollBar);
connect(current, &KItemListView::scrollTo, this, &KItemListContainer::scrollTo);
+ connect(m_horizontalSmoothScroller, &KItemListSmoothScroller::scrollingStopped, current, &KItemListView::scrollingStopped);
+ connect(m_verticalSmoothScroller, &KItemListSmoothScroller::scrollingStopped, current, &KItemListView::scrollingStopped);
+
m_horizontalSmoothScroller->setTargetObject(current);
m_verticalSmoothScroller->setTargetObject(current);
updateSmoothScrollers(current->scrollOrientation());
void KItemListContainer::scrollTo(qreal offset)
{
- const KItemListView* view = m_controller->view();
+ const KItemListView *view = m_controller->view();
if (view) {
if (view->scrollOrientation() == Qt::Vertical) {
m_verticalSmoothScroller->scrollTo(offset);
void KItemListContainer::updateScrollOffsetScrollBar()
{
- const KItemListView* view = m_controller->view();
+ const KItemListView *view = m_controller->view();
if (!view) {
return;
}
- KItemListSmoothScroller* smoothScroller = 0;
- QScrollBar* scrollOffsetScrollBar = 0;
+ KItemListSmoothScroller *smoothScroller = nullptr;
+ QScrollBar *scrollOffsetScrollBar = nullptr;
int singleStep = 0;
int pageStep = 0;
int maximum = 0;
if (view->scrollOrientation() == Qt::Vertical) {
smoothScroller = m_verticalSmoothScroller;
scrollOffsetScrollBar = verticalScrollBar();
- singleStep = view->itemSize().height();
+
+ // Don't scroll super fast when using a wheel mouse:
+ // We want to consider one "line" to be the text label which has a
+ // roughly fixed height rather than using the height of the icon which
+ // may be very tall
+ const QFontMetrics metrics(font());
+ singleStep = metrics.height() * QApplication::wheelScrollLines();
+
// We cannot use view->size().height() because this height might
// include the header widget, which is not part of the scrolled area.
pageStep = view->verticalPageStep();
const int value = view->scrollOffset();
if (smoothScroller->requestScrollBarUpdate(maximum)) {
- const bool updatePolicy = (scrollOffsetScrollBar->maximum() > 0 && maximum == 0)
- || horizontalScrollBarPolicy() == Qt::ScrollBarAlwaysOn;
+ const bool updatePolicy = (scrollOffsetScrollBar->maximum() > 0 && maximum == 0) || horizontalScrollBarPolicy() == Qt::ScrollBarAlwaysOn;
scrollOffsetScrollBar->setSingleStep(singleStep);
scrollOffsetScrollBar->setPageStep(pageStep);
void KItemListContainer::updateItemOffsetScrollBar()
{
- const KItemListView* view = m_controller->view();
+ const KItemListView *view = m_controller->view();
if (!view) {
return;
}
- KItemListSmoothScroller* smoothScroller = 0;
- QScrollBar* itemOffsetScrollBar = 0;
+ KItemListSmoothScroller *smoothScroller = nullptr;
+ QScrollBar *itemOffsetScrollBar = nullptr;
int singleStep = 0;
int pageStep = 0;
if (view->scrollOrientation() == Qt::Vertical) {
}
}
+void KItemListContainer::stopScroller()
+{
+ m_scroller->stop();
+}
+
void KItemListContainer::updateGeometries()
{
QRect rect = geometry();
scrollbarSpacing = style()->pixelMetric(QStyle::PM_ScrollView_ScrollBarSpacing, &option, this);
}
- const int widthDec = verticalScrollBar()->isVisible()
- ? extra + scrollbarSpacing + style()->pixelMetric(QStyle::PM_ScrollBarExtent, &option, this)
- : extra;
+ const int widthDec = verticalScrollBar()->isVisible() ? extra + scrollbarSpacing + style()->pixelMetric(QStyle::PM_ScrollBarExtent, &option, this) : extra;
- const int heightDec = horizontalScrollBar()->isVisible()
- ? extra + scrollbarSpacing + style()->pixelMetric(QStyle::PM_ScrollBarExtent, &option, this)
- : extra;
+ const int heightDec =
+ horizontalScrollBar()->isVisible() ? extra + scrollbarSpacing + style()->pixelMetric(QStyle::PM_ScrollBarExtent, &option, this) : extra;
- const QRectF newGeometry(0, 0, rect.width() - widthDec,
- rect.height() - heightDec);
+ const QRectF newGeometry(0, 0, rect.width() - widthDec, rect.height() - heightDec);
if (m_controller->view()->geometry() != newGeometry) {
m_controller->view()->setGeometry(newGeometry);
// Get the real geometry of the view again since the scrollbars
// visibilities and the view geometry may have changed in re-layout.
- static_cast<KItemListContainerViewport*>(viewport())->scene()->setSceneRect(m_controller->view()->geometry());
- static_cast<KItemListContainerViewport*>(viewport())->viewport()->setGeometry(m_controller->view()->geometry().toRect());
+ static_cast<KItemListContainerViewport *>(viewport())->scene()->setSceneRect(m_controller->view()->geometry());
+ static_cast<KItemListContainerViewport *>(viewport())->viewport()->setGeometry(m_controller->view()->geometry().toRect());
updateScrollOffsetScrollBar();
updateItemOffsetScrollBar();
m_horizontalSmoothScroller->setPropertyName("scrollOffset");
m_verticalSmoothScroller->setPropertyName("itemOffset");
}
+
+ const bool isRightToLeft = m_controller->view()->layoutDirection() == Qt::RightToLeft;
+ QScrollBar *hScrollBar = horizontalScrollBar();
+ hScrollBar->setInvertedAppearance(isRightToLeft && orientation == Qt::Vertical);
+ hScrollBar->setInvertedControls(!isRightToLeft || orientation == Qt::Vertical);
}
void KItemListContainer::updateScrollOffsetScrollBarPolicy()
{
- const KItemListView* view = m_controller->view();
+ const KItemListView *view = m_controller->view();
Q_ASSERT(view);
const bool vertical = (view->scrollOrientation() == Qt::Vertical);
newViewSize.rheight() += scrollBarInc;
}
- const Qt::ScrollBarPolicy policy = view->scrollBarRequired(newViewSize)
- ? Qt::ScrollBarAlwaysOn : Qt::ScrollBarAsNeeded;
+ const Qt::ScrollBarPolicy policy = view->scrollBarRequired(newViewSize) ? Qt::ScrollBarAlwaysOn : Qt::ScrollBarAsNeeded;
if (vertical) {
setVerticalScrollBarPolicy(policy);
} else {
}
}
+#include "kitemlistcontainer.moc"
+#include "moc_kitemlistcontainer.cpp"