src/hbwidgets/itemviews/hbabstractitemview.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 19 Apr 2010 14:02:13 +0300
changeset 0 16d8024aca5e
child 1 f7ac710697a9
permissions -rw-r--r--
Revision: 201011 Kit: 201015

/****************************************************************************
**
** 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 &current, 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