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;
|
2011-08-28 22:42:05 +00:00
|
|
|
class KItemListKeyboardSearchManager;
|
2011-07-30 18:13:09 +00:00
|
|
|
class KItemListSelectionManager;
|
|
|
|
class KItemListView;
|
2011-09-04 15:40:44 +00:00
|
|
|
class KItemListWidget;
|
2011-07-30 18:13:09 +00:00
|
|
|
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)
|
2012-09-19 17:00:52 +00:00
|
|
|
Q_PROPERTY(AutoActivationBehavior autoActivationBehavior READ autoActivationBehavior WRITE setAutoActivationBehavior)
|
2012-09-20 15:56:32 +00:00
|
|
|
Q_PROPERTY(MouseDoubleClickAction mouseDoubleClickAction READ mouseDoubleClickAction WRITE setMouseDoubleClickAction)
|
2011-07-30 18:13:09 +00:00
|
|
|
|
|
|
|
public:
|
|
|
|
enum SelectionBehavior {
|
|
|
|
NoSelection,
|
|
|
|
SingleSelection,
|
|
|
|
MultiSelection
|
|
|
|
};
|
|
|
|
|
2012-09-19 17:00:52 +00:00
|
|
|
enum AutoActivationBehavior {
|
|
|
|
ActivationAndExpansion,
|
|
|
|
ExpansionOnly
|
|
|
|
};
|
|
|
|
|
2012-09-20 15:56:32 +00:00
|
|
|
enum MouseDoubleClickAction {
|
|
|
|
ActivateAndExpandItem,
|
|
|
|
ActivateItemOnly
|
|
|
|
};
|
|
|
|
|
2012-04-21 19:28:16 +00:00
|
|
|
/**
|
|
|
|
* @param model Model of the controller. The ownership is passed to the controller.
|
|
|
|
* @param view View of the controller. The ownership is passed to the controller.
|
|
|
|
* @param parent Optional parent object.
|
|
|
|
*/
|
|
|
|
KItemListController(KItemModelBase* model, KItemListView* view, QObject* parent = 0);
|
2011-07-30 18:13:09 +00:00
|
|
|
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;
|
|
|
|
|
2012-09-19 17:00:52 +00:00
|
|
|
void setAutoActivationBehavior(AutoActivationBehavior behavior);
|
|
|
|
AutoActivationBehavior autoActivationBehavior() const;
|
|
|
|
|
2012-09-20 15:56:32 +00:00
|
|
|
void setMouseDoubleClickAction(MouseDoubleClickAction action);
|
|
|
|
MouseDoubleClickAction mouseDoubleClickAction() const;
|
|
|
|
|
2011-11-29 21:01:16 +00:00
|
|
|
/**
|
|
|
|
* Sets the delay in milliseconds when dragging an object above an item
|
|
|
|
* until the item gets activated automatically. A value of -1 indicates
|
|
|
|
* that no automatic activation will be done at all (= default value).
|
|
|
|
*
|
|
|
|
* The hovered item must support dropping (see KItemModelBase::supportsDropping()),
|
|
|
|
* otherwise the automatic activation is not available.
|
|
|
|
*
|
|
|
|
* After activating the item the signal itemActivated() will be
|
|
|
|
* emitted. If the view supports the expanding of items
|
|
|
|
* (KItemListView::supportsItemExpanding() returns true) and the item
|
|
|
|
* itself is expandable (see KItemModelBase::isExpandable()) then instead
|
|
|
|
* of activating the item it gets expanded instead (see
|
|
|
|
* KItemModelBase::setExpanded()).
|
|
|
|
*/
|
|
|
|
void setAutoActivationDelay(int delay);
|
|
|
|
int autoActivationDelay() const;
|
|
|
|
|
2012-01-05 19:41:59 +00:00
|
|
|
/**
|
|
|
|
* If set to true, the signals itemActivated() and itemsActivated() are emitted
|
2013-02-05 18:58:06 +00:00
|
|
|
* after a single-click of the left mouse button. If set to false (the default),
|
|
|
|
* the setting from KGlobalSettings::singleClick() is used.
|
2012-01-05 19:41:59 +00:00
|
|
|
*/
|
2013-02-05 18:58:06 +00:00
|
|
|
void setSingleClickActivationEnforced(bool singleClick);
|
|
|
|
bool singleClickActivationEnforced() const;
|
2012-01-05 19:41:59 +00:00
|
|
|
|
2011-07-30 18:13:09 +00:00
|
|
|
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:
|
2011-11-29 21:01:16 +00:00
|
|
|
/**
|
|
|
|
* Is emitted if exactly one item has been activated by e.g. a mouse-click
|
|
|
|
* or by pressing Return/Enter.
|
|
|
|
*/
|
2011-08-29 15:43:36 +00:00
|
|
|
void itemActivated(int index);
|
2011-11-29 21:01:16 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Is emitted if more than one item has been activated by pressing Return/Enter
|
|
|
|
* when having a selection.
|
|
|
|
*/
|
|
|
|
void itemsActivated(const QSet<int>& indexes);
|
|
|
|
|
2011-08-29 15:43:36 +00:00
|
|
|
void itemMiddleClicked(int index);
|
2011-10-08 19:40:34 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Emitted if a context-menu is requested for the item with
|
|
|
|
* the index \a index. It is assured that the index is valid.
|
|
|
|
*/
|
|
|
|
void itemContextMenuRequested(int index, const QPointF& pos);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Emitted if a context-menu is requested for the KItemListView.
|
|
|
|
*/
|
|
|
|
void viewContextMenuRequested(const QPointF& pos);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Emitted if a context-menu is requested for the header of the KItemListView.
|
|
|
|
*/
|
|
|
|
void headerContextMenuRequested(const QPointF& pos);
|
2011-08-08 21:41:18 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Is emitted if the item with the index \p index gets hovered.
|
|
|
|
*/
|
|
|
|
void itemHovered(int index);
|
2011-09-04 15:40:44 +00:00
|
|
|
|
2011-08-08 21:41:18 +00:00
|
|
|
/**
|
|
|
|
* 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-12-18 19:28:47 +00:00
|
|
|
/**
|
|
|
|
* Is emitted if a mouse-button has been pressed above an item.
|
2012-03-19 15:47:11 +00:00
|
|
|
* If the index is smaller than 0, the mouse-button has been pressed
|
|
|
|
* above the viewport.
|
2011-12-18 19:28:47 +00:00
|
|
|
*/
|
2012-03-19 15:47:11 +00:00
|
|
|
void mouseButtonPressed(int itemIndex, Qt::MouseButtons buttons);
|
2011-12-18 19:28:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Is emitted if a mouse-button has been released above an item.
|
2012-03-19 15:47:11 +00:00
|
|
|
* It is assured that the signal mouseButtonPressed() has been emitted before.
|
|
|
|
* If the index is smaller than 0, the mouse-button has been pressed
|
|
|
|
* above the viewport.
|
2011-12-18 19:28:47 +00:00
|
|
|
*/
|
2012-03-19 15:47:11 +00:00
|
|
|
void mouseButtonReleased(int itemIndex, Qt::MouseButtons buttons);
|
2011-12-18 19:28:47 +00:00
|
|
|
|
2011-07-30 18:13:09 +00:00
|
|
|
void itemExpansionToggleClicked(int index);
|
|
|
|
|
2011-09-04 15:40:44 +00:00
|
|
|
/**
|
|
|
|
* Is emitted if a drop event is done above the item with the index
|
|
|
|
* \a index. If \a index is < 0 the drop event is done above an
|
|
|
|
* empty area of the view.
|
2012-07-11 22:27:53 +00:00
|
|
|
* TODO: Introduce a new signal viewDropEvent(QGraphicsSceneDragDropEvent),
|
|
|
|
* which is emitted if the drop event occurs on an empty area in
|
|
|
|
* the view, and make sure that index is always >= 0 in itemDropEvent().
|
2011-09-04 15:40:44 +00:00
|
|
|
*/
|
|
|
|
void itemDropEvent(int index, QGraphicsSceneDragDropEvent* event);
|
|
|
|
|
2012-07-11 22:27:53 +00:00
|
|
|
/**
|
|
|
|
* Is emitted if a drop event is done between the item with the index
|
|
|
|
* \a index and the previous item.
|
|
|
|
*/
|
|
|
|
void aboveItemDropEvent(int index, QGraphicsSceneDragDropEvent* event);
|
|
|
|
|
2011-07-30 18:13:09 +00:00
|
|
|
void modelChanged(KItemModelBase* current, KItemModelBase* previous);
|
|
|
|
void viewChanged(KItemListView* current, KItemListView* previous);
|
|
|
|
|
2011-08-18 21:11:16 +00:00
|
|
|
private slots:
|
2011-09-25 17:52:33 +00:00
|
|
|
void slotViewScrollOffsetChanged(qreal current, qreal previous);
|
2011-08-18 21:11:16 +00:00
|
|
|
|
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-08-29 18:13:39 +00:00
|
|
|
void slotChangeCurrentItem(const QString& text, bool searchFromNextItem);
|
2011-08-28 22:42:05 +00:00
|
|
|
|
2011-11-29 21:01:16 +00:00
|
|
|
void slotAutoActivationTimeout();
|
|
|
|
|
2011-07-30 18:13:09 +00:00
|
|
|
private:
|
2011-08-23 18:55:41 +00:00
|
|
|
/**
|
2011-09-01 21:08:22 +00:00
|
|
|
* Creates a QDrag object and initiates a drag-operation.
|
2011-08-23 18:55:41 +00:00
|
|
|
*/
|
2011-09-01 21:08:22 +00:00
|
|
|
void startDragging();
|
2011-08-23 18:55:41 +00:00
|
|
|
|
2011-09-04 15:40:44 +00:00
|
|
|
/**
|
|
|
|
* @return Widget that is currently in the hovered state. 0 is returned
|
|
|
|
* if no widget is marked as hovered.
|
|
|
|
*/
|
|
|
|
KItemListWidget* hoveredWidget() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return Widget that is below the position \a pos. 0 is returned
|
|
|
|
* if no widget is below the position.
|
|
|
|
*/
|
|
|
|
KItemListWidget* widgetForPos(const QPointF& pos) const;
|
|
|
|
|
2011-12-26 21:16:32 +00:00
|
|
|
/**
|
|
|
|
* Updates m_keyboardAnchorIndex and m_keyboardAnchorPos. If no anchor is
|
|
|
|
* set, it will be adjusted to the current item. If it is set it will be
|
|
|
|
* checked whether it is still valid, otherwise it will be reset to the
|
|
|
|
* current item.
|
|
|
|
*/
|
|
|
|
void updateKeyboardAnchor();
|
|
|
|
|
|
|
|
/**
|
2012-01-18 09:18:47 +00:00
|
|
|
* @return Index for the next row based on \a index.
|
|
|
|
* If there is no next row \a index will be returned.
|
2011-12-26 21:16:32 +00:00
|
|
|
*/
|
2012-01-18 09:18:47 +00:00
|
|
|
int nextRowIndex(int index) const;
|
2011-12-26 21:16:32 +00:00
|
|
|
|
|
|
|
/**
|
2012-01-18 09:18:47 +00:00
|
|
|
* @return Index for the previous row based on \a index.
|
|
|
|
* If there is no previous row \a index will be returned.
|
2011-12-26 21:16:32 +00:00
|
|
|
*/
|
2012-01-18 09:18:47 +00:00
|
|
|
int previousRowIndex(int index) const;
|
2011-12-26 21:16:32 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper method for updateKeyboardAnchor(), previousRowIndex() and nextRowIndex().
|
|
|
|
* @return The position of the keyboard anchor for the item with the index \a index.
|
|
|
|
* If a horizontal scrolling is used the y-position of the item will be returned,
|
|
|
|
* for the vertical scrolling the x-position will be returned.
|
|
|
|
*/
|
|
|
|
qreal keyboardAnchorPos(int index) const;
|
|
|
|
|
2012-04-21 19:28:16 +00:00
|
|
|
/**
|
|
|
|
* Dependent on the selection-behavior the extendedSelectionRegion-property
|
|
|
|
* of the KItemListStyleOption from the view should be adjusted: If no
|
|
|
|
* rubberband selection is used the property should be enabled.
|
|
|
|
*/
|
|
|
|
void updateExtendedSelectionRegion();
|
|
|
|
|
2011-08-23 18:55:41 +00:00
|
|
|
private:
|
2013-02-05 18:58:06 +00:00
|
|
|
bool m_singleClickActivationEnforced;
|
2011-11-13 15:20:42 +00:00
|
|
|
bool m_selectionTogglePressed;
|
2012-01-16 18:59:54 +00:00
|
|
|
bool m_clearSelectionIfItemsAreNotDragged;
|
2011-07-30 18:13:09 +00:00
|
|
|
SelectionBehavior m_selectionBehavior;
|
2012-09-19 17:00:52 +00:00
|
|
|
AutoActivationBehavior m_autoActivationBehavior;
|
2012-09-20 15:56:32 +00:00
|
|
|
MouseDoubleClickAction m_mouseDoubleClickAction;
|
2011-07-30 18:13:09 +00:00
|
|
|
KItemModelBase* m_model;
|
|
|
|
KItemListView* m_view;
|
|
|
|
KItemListSelectionManager* m_selectionManager;
|
2011-08-28 22:42:05 +00:00
|
|
|
KItemListKeyboardSearchManager* m_keyboardManager;
|
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
|
|
|
|
2011-11-29 21:01:16 +00:00
|
|
|
QTimer* m_autoActivationTimer;
|
|
|
|
|
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
|
2011-12-26 21:16:32 +00:00
|
|
|
* the current selection it is remembered in m_oldSelection before the
|
2011-08-20 21:26:07 +00:00
|
|
|
* rubberband gets activated.
|
|
|
|
*/
|
|
|
|
QSet<int> m_oldSelection;
|
2011-12-26 21:16:32 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Assuming a view is given with a vertical scroll-orientation, grouped items and
|
|
|
|
* a maximum of 4 columns:
|
|
|
|
*
|
|
|
|
* 1 2 3 4
|
|
|
|
* 5 6 7
|
|
|
|
* 8 9 10 11
|
|
|
|
* 12 13 14
|
|
|
|
*
|
|
|
|
* If the current index is on 4 and key-down is pressed, then item 7 gets the current
|
|
|
|
* item. Now when pressing key-down again item 11 should get the current item and not
|
|
|
|
* item 10. This makes it necessary to keep track of the requested column to have a
|
|
|
|
* similar behavior like in a text editor:
|
|
|
|
*/
|
|
|
|
int m_keyboardAnchorIndex;
|
2011-12-26 21:42:49 +00:00
|
|
|
qreal m_keyboardAnchorPos;
|
2011-07-30 18:13:09 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|