2011-07-30 18:13:09 +00:00
|
|
|
/***************************************************************************
|
|
|
|
* 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 *
|
|
|
|
***************************************************************************/
|
|
|
|
|
|
|
|
#ifndef KITEMLISTCONTROLLER_H
|
|
|
|
#define KITEMLISTCONTROLLER_H
|
|
|
|
|
|
|
|
#include <libdolphin_export.h>
|
|
|
|
|
|
|
|
#include <QObject>
|
2011-08-23 18:55:41 +00:00
|
|
|
#include <QPixmap>
|
|
|
|
#include <QPointF>
|
2011-08-20 21:26:07 +00:00
|
|
|
#include <QSet>
|
2011-07-30 18:13:09 +00:00
|
|
|
|
|
|
|
class KItemModelBase;
|
|
|
|
class KItemListSelectionManager;
|
|
|
|
class KItemListView;
|
|
|
|
class QGraphicsSceneHoverEvent;
|
|
|
|
class QGraphicsSceneDragDropEvent;
|
|
|
|
class QGraphicsSceneMouseEvent;
|
|
|
|
class QGraphicsSceneResizeEvent;
|
|
|
|
class QGraphicsSceneWheelEvent;
|
|
|
|
class QHideEvent;
|
|
|
|
class QInputMethodEvent;
|
|
|
|
class QKeyEvent;
|
2011-08-23 18:55:41 +00:00
|
|
|
class QMimeData;
|
2011-07-30 18:13:09 +00:00
|
|
|
class QShowEvent;
|
|
|
|
class QTransform;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Controls the view, model and selection of an item-list.
|
|
|
|
*
|
|
|
|
* For a working item-list it is mandatory to set a compatible view and model
|
|
|
|
* with KItemListController::setView() and KItemListController::setModel().
|
|
|
|
*
|
|
|
|
* @see KItemListView
|
|
|
|
* @see KItemModelBase
|
|
|
|
* @see KItemListSelectionManager
|
|
|
|
*/
|
|
|
|
class LIBDOLPHINPRIVATE_EXPORT KItemListController : public QObject
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
Q_ENUMS(SelectionBehavior)
|
|
|
|
Q_PROPERTY(KItemModelBase* model READ model WRITE setModel)
|
|
|
|
Q_PROPERTY(KItemListView *view READ view WRITE setView)
|
|
|
|
Q_PROPERTY(SelectionBehavior selectionBehavior READ selectionBehavior WRITE setSelectionBehavior)
|
|
|
|
|
|
|
|
public:
|
|
|
|
enum SelectionBehavior {
|
|
|
|
NoSelection,
|
|
|
|
SingleSelection,
|
|
|
|
MultiSelection
|
|
|
|
};
|
|
|
|
|
|
|
|
KItemListController(QObject* parent = 0);
|
|
|
|
virtual ~KItemListController();
|
|
|
|
|
|
|
|
void setModel(KItemModelBase* model);
|
|
|
|
KItemModelBase* model() const;
|
|
|
|
|
|
|
|
void setView(KItemListView* view);
|
|
|
|
KItemListView* view() const;
|
|
|
|
|
|
|
|
KItemListSelectionManager* selectionManager() const;
|
|
|
|
|
|
|
|
void setSelectionBehavior(SelectionBehavior behavior);
|
|
|
|
SelectionBehavior selectionBehavior() const;
|
|
|
|
|
|
|
|
virtual bool showEvent(QShowEvent* event);
|
|
|
|
virtual bool hideEvent(QHideEvent* event);
|
|
|
|
virtual bool keyPressEvent(QKeyEvent* event);
|
|
|
|
virtual bool inputMethodEvent(QInputMethodEvent* event);
|
|
|
|
virtual bool mousePressEvent(QGraphicsSceneMouseEvent* event, const QTransform& transform);
|
|
|
|
virtual bool mouseMoveEvent(QGraphicsSceneMouseEvent* event, const QTransform& transform);
|
|
|
|
virtual bool mouseReleaseEvent(QGraphicsSceneMouseEvent* event, const QTransform& transform);
|
|
|
|
virtual bool mouseDoubleClickEvent(QGraphicsSceneMouseEvent* event, const QTransform& transform);
|
|
|
|
virtual bool dragEnterEvent(QGraphicsSceneDragDropEvent* event, const QTransform& transform);
|
|
|
|
virtual bool dragLeaveEvent(QGraphicsSceneDragDropEvent* event, const QTransform& transform);
|
|
|
|
virtual bool dragMoveEvent(QGraphicsSceneDragDropEvent* event, const QTransform& transform);
|
|
|
|
virtual bool dropEvent(QGraphicsSceneDragDropEvent* event, const QTransform& transform);
|
|
|
|
virtual bool hoverEnterEvent(QGraphicsSceneHoverEvent* event, const QTransform& transform);
|
|
|
|
virtual bool hoverMoveEvent(QGraphicsSceneHoverEvent* event, const QTransform& transform);
|
|
|
|
virtual bool hoverLeaveEvent(QGraphicsSceneHoverEvent* event, const QTransform& transform);
|
|
|
|
virtual bool wheelEvent(QGraphicsSceneWheelEvent* event, const QTransform& transform);
|
|
|
|
virtual bool resizeEvent(QGraphicsSceneResizeEvent* event, const QTransform& transform);
|
|
|
|
virtual bool processEvent(QEvent* event, const QTransform& transform);
|
|
|
|
|
|
|
|
signals:
|
|
|
|
void itemClicked(int index, Qt::MouseButton button);
|
2011-08-08 21:41:18 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Is emitted if the item with the index \p index gets hovered.
|
|
|
|
*/
|
|
|
|
void itemHovered(int index);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Is emitted if the item with the index \p index gets unhovered.
|
|
|
|
* It is assured that the signal itemHovered() for this index
|
|
|
|
* has been emitted before.
|
|
|
|
*/
|
|
|
|
void itemUnhovered(int index);
|
|
|
|
|
2011-07-30 18:13:09 +00:00
|
|
|
void itemExpansionToggleClicked(int index);
|
|
|
|
|
|
|
|
void modelChanged(KItemModelBase* current, KItemModelBase* previous);
|
|
|
|
void viewChanged(KItemListView* current, KItemListView* previous);
|
|
|
|
|
2011-08-18 21:11:16 +00:00
|
|
|
private slots:
|
|
|
|
void slotViewOffsetChanged(qreal current, qreal previous);
|
|
|
|
|
2011-08-20 20:52:45 +00:00
|
|
|
/**
|
|
|
|
* Is invoked when the rubberband boundaries have been changed and will select
|
|
|
|
* all items that are touched by the rubberband.
|
|
|
|
*/
|
|
|
|
void slotRubberBandChanged();
|
|
|
|
|
2011-07-30 18:13:09 +00:00
|
|
|
private:
|
2011-08-23 18:55:41 +00:00
|
|
|
/**
|
|
|
|
* Creates a QDrag object to start a drag-operation.
|
|
|
|
*/
|
|
|
|
void startDragging();
|
|
|
|
|
|
|
|
private:
|
|
|
|
bool m_dragging;
|
2011-07-30 18:13:09 +00:00
|
|
|
SelectionBehavior m_selectionBehavior;
|
|
|
|
KItemModelBase* m_model;
|
|
|
|
KItemListView* m_view;
|
|
|
|
KItemListSelectionManager* m_selectionManager;
|
2011-08-02 07:24:17 +00:00
|
|
|
int m_pressedIndex;
|
2011-08-23 18:55:41 +00:00
|
|
|
QPointF m_pressedMousePos;
|
2011-08-20 21:26:07 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* When starting a rubberband selection during a Shift- or Control-key has been
|
|
|
|
* pressed the current selection should never be deleted. To be able to restore
|
|
|
|
* the current selection it is remembered in m_oldSelection before
|
|
|
|
* rubberband gets activated.
|
|
|
|
*/
|
|
|
|
QSet<int> m_oldSelection;
|
2011-07-30 18:13:09 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|