--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/hbwidgets/itemviews/hbabstractitemview.h Mon Apr 19 14:02:13 2010 +0300
@@ -0,0 +1,228 @@
+/****************************************************************************
+**
+** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (developer.feedback@nokia.com)
+**
+** This file is part of the HbWidgets module of the UI Extensions for Mobile.
+**
+** GNU Lesser General Public License Usage
+** This file may be used under the terms of the GNU Lesser General Public
+** License version 2.1 as published by the Free Software Foundation and
+** appearing in the file LICENSE.LGPL included in the packaging of this file.
+** Please review the following information to ensure the GNU Lesser General
+** Public License version 2.1 requirements will be met:
+** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at developer.feedback@nokia.com.
+**
+****************************************************************************/
+
+#ifndef HBABSTRACTITEMVIEW_H
+#define HBABSTRACTITEMVIEW_H
+
+#include <hbscrollarea.h>
+#include <hbglobal.h>
+#include <hbeffect.h>
+
+#include <QItemSelectionModel>
+
+class HbAbstractItemViewPrivate;
+class HbAbstractViewItem;
+class HbAbstractItemContainer;
+class HbModelIterator;
+
+class HB_WIDGETS_EXPORT HbAbstractItemView : public HbScrollArea
+{
+ Q_OBJECT
+
+ Q_ENUMS(SelectionMode ScrollHint)
+ Q_FLAGS(ItemAnimations)
+
+ Q_PROPERTY(bool itemRecycling READ itemRecycling WRITE setItemRecycling)
+ Q_PROPERTY(SelectionMode selectionMode READ selectionMode WRITE setSelectionMode)
+ Q_PROPERTY(QString layoutName READ layoutName WRITE setLayoutName)
+ Q_PROPERTY(bool uniformItemSizes READ uniformItemSizes WRITE setUniformItemSizes)
+ Q_PROPERTY(ItemAnimations enabledAnimations READ enabledAnimations WRITE setEnabledAnimations)
+
+public:
+
+ enum SelectionMode
+ {
+ NoSelection,
+ SingleSelection,
+ MultiSelection,
+ ContiguousSelection
+ };
+
+ enum ScrollHint
+ {
+ EnsureVisible,
+ PositionAtTop,
+ PositionAtBottom,
+ PositionAtCenter
+ };
+
+ enum ItemAnimation
+ {
+ None = 0x00000,
+ Appear = 0x00001,
+ Disappear = 0x00002,
+ TouchDown = 0x00004,
+ All = 0xFFFFF
+ };
+
+ Q_DECLARE_FLAGS(ItemAnimations, ItemAnimation)
+
+
+public:
+ virtual ~HbAbstractItemView();
+
+ enum { Type = Hb::ItemType_AbstractItemView };
+ int type() const;
+
+ virtual void setModel(QAbstractItemModel *model, HbAbstractViewItem *prototype = 0);
+ QAbstractItemModel *model() const;
+
+ void setItemPrototype(HbAbstractViewItem *prototype);
+
+ void setItemPrototypes(const QList<HbAbstractViewItem *> &prototypes);
+ QList<HbAbstractViewItem *> itemPrototypes() const;
+
+ void setSelectionModel(QItemSelectionModel *selectionModel);
+ QItemSelectionModel *selectionModel() const;
+
+ QModelIndex currentIndex() const;
+
+ QModelIndex rootIndex() const;
+
+ void setSelectionMode(SelectionMode newMode, bool resetSelection);
+ void setSelectionMode(SelectionMode newMode);
+ SelectionMode selectionMode() const;
+
+ void setItemRecycling(bool enabled);
+ bool itemRecycling() const;
+
+ bool isVisible(const QModelIndex &index) const;
+ bool isVisible(HbAbstractViewItem *item) const;
+ HbAbstractViewItem *currentViewItem() const;
+
+ HbAbstractViewItem *itemByIndex(const QModelIndex &index) const;
+
+ virtual void scrollTo(const QModelIndex &index, ScrollHint hint = EnsureVisible) = 0;
+ QList<HbAbstractViewItem *> visibleItems() const;
+
+ HbAbstractViewItem *itemAtPosition(const QPointF& position) const;
+
+ virtual int indexCount() const;
+ virtual int indexPosition(const QModelIndex &index) const;
+
+ virtual QModelIndex nextIndex(const QModelIndex &index) const;
+ virtual QModelIndex previousIndex(const QModelIndex &index) const;
+
+ QString layoutName() const;
+ void setLayoutName(const QString &layoutName);
+
+ void setUniformItemSizes(bool enable);
+ bool uniformItemSizes() const;
+
+ HbModelIterator *modelIterator() const;
+
+ void setEnabledAnimations(ItemAnimations flags);
+ ItemAnimations enabledAnimations() const;
+
+public slots:
+ void setCurrentIndex(const QModelIndex &index,
+ QItemSelectionModel::SelectionFlags selectionFlag
+ = QItemSelectionModel::NoUpdate);
+ virtual void setRootIndex(const QModelIndex &index);
+ virtual void reset();
+ virtual void selectAll();
+ virtual void clearSelection();
+
+signals:
+ void pressed(const QModelIndex &index);
+ void released(const QModelIndex &index);
+ void activated(const QModelIndex &index);
+ void longPressed(HbAbstractViewItem *item, const QPointF &coords);
+
+protected:
+ HbAbstractItemView(HbAbstractItemViewPrivate &dd,
+ HbAbstractItemContainer *container,
+ QGraphicsItem *parent = 0);
+
+ HbAbstractItemView(HbAbstractItemViewPrivate &dd,
+ HbAbstractItemContainer *container,
+ HbModelIterator *modelIterator,
+ QGraphicsItem *parent = 0);
+ virtual QItemSelectionModel::SelectionFlags selectionCommand(
+ const HbAbstractViewItem *item,
+ const QEvent *event);
+ bool event(QEvent *e);
+ void mousePressEvent(QGraphicsSceneMouseEvent *event);
+ void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
+ void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
+ void focusOutEvent(QFocusEvent *event);
+
+ virtual void upGesture(int value);
+ virtual void downGesture(int value);
+ virtual void leftGesture(int value);
+ virtual void rightGesture(int value);
+
+ virtual void emitActivated(const QModelIndex &modelIndex);
+ virtual void emitPressed(const QModelIndex &modelIndex);
+ virtual void emitReleased(const QModelIndex &modelIndex);
+
+ virtual bool scrollByAmount(const QPointF &delta);
+
+ HbAbstractItemContainer *container() const;
+
+ QVariant itemChange(GraphicsItemChange change, const QVariant &value);
+ bool sceneEventFilter(QGraphicsItem *watched, QEvent *event);
+
+protected slots:
+
+ virtual void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight);
+
+ virtual void orientationChanged(Qt::Orientation newOrientation);
+ virtual void orientationAboutToBeChanged();
+
+ virtual void currentIndexChanged(const QModelIndex ¤t, const QModelIndex &previous);
+ virtual void currentSelectionChanged(const QItemSelection &selected, const QItemSelection &deselected);
+
+ virtual void rowsAboutToBeInserted(const QModelIndex &index, int start, int end);
+ virtual void rowsInserted(const QModelIndex &parent, int start, int end);
+
+ virtual void rowsAboutToBeRemoved(const QModelIndex &index, int start, int end);
+ virtual void rowsRemoved(const QModelIndex &parent, int start, int end);
+
+ virtual void columnsAboutToBeInserted(const QModelIndex &index, int start, int end);
+ virtual void columnsInserted(const QModelIndex &parent, int start, int end);
+
+ virtual void columnsAboutToBeRemoved(const QModelIndex &index, int start, int end);
+ virtual void columnsRemoved(const QModelIndex &parent, int start, int end);
+
+ virtual void panGesture(const QPointF &point);
+ virtual void longPressGesture(const QPointF &point);
+
+private:
+ Q_DECLARE_PRIVATE_D(d_ptr, HbAbstractItemView)
+ Q_DISABLE_COPY(HbAbstractItemView)
+ Q_PRIVATE_SLOT(d_func(), void _q_modelDestroyed())
+ Q_PRIVATE_SLOT(d_func(), void _q_layoutChanged())
+ Q_PRIVATE_SLOT(d_func(), void _q_animationEnabled())
+ Q_PRIVATE_SLOT(d_func(), void _q_animationFinished(const HbEffect::EffectStatus &status))
+
+ friend class HbAbstractItemContainer;
+};
+
+Q_DECLARE_METATYPE(HbAbstractItemView::SelectionMode)
+
+Q_DECLARE_OPERATORS_FOR_FLAGS(HbAbstractItemView::ItemAnimations)
+
+#endif // HBABSTRACTITEMVIEW_H