ganeswidgets/inc/hgcontainer.h
author hgs
Fri, 17 Sep 2010 15:55:58 +0300
changeset 17 a10844a9914d
parent 12 6c0ec0ccd2d4
child 20 a60f8b6b1d32
permissions -rw-r--r--
201037
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
6
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef HGCONTAINER_H
hgs
parents:
diff changeset
    19
#define HGCONTAINER_H
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include <QTime>
hgs
parents:
diff changeset
    22
#include <HbWidget>
hgs
parents:
diff changeset
    23
#include <hgwidgets/hgwidgets.h>
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
#include "hgmediawalldataprovider.h"
hgs
parents:
diff changeset
    26
#include "hgdrag.h"
hgs
parents:
diff changeset
    27
#include "hgspring.h"
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
class HgWidgetItem;
hgs
parents:
diff changeset
    30
class HgQuadRenderer;
hgs
parents:
diff changeset
    31
class HgMediaWallRenderer;
hgs
parents:
diff changeset
    32
class QPanGesture;
hgs
parents:
diff changeset
    33
class HbAbstractViewItem;
hgs
parents:
diff changeset
    34
class HbGestureSceneFilter;
hgs
parents:
diff changeset
    35
class HgLongPressVisualizer;
hgs
parents:
diff changeset
    36
hgs
parents:
diff changeset
    37
class HgContainer: public HbWidget, public HgMediaWallDataProvider
hgs
parents:
diff changeset
    38
{
hgs
parents:
diff changeset
    39
    Q_OBJECT
hgs
parents:
diff changeset
    40
    Q_DISABLE_COPY(HgContainer)
hgs
parents:
diff changeset
    41
hgs
parents:
diff changeset
    42
public:
hgs
parents:
diff changeset
    43
    explicit HgContainer(QGraphicsItem* parent = 0);
hgs
parents:
diff changeset
    44
    virtual ~HgContainer();
hgs
parents:
diff changeset
    45
hgs
parents:
diff changeset
    46
    void setItemCount(int count);
hgs
parents:
diff changeset
    47
    int itemCount() const;
17
hgs
parents: 12
diff changeset
    48
    int currentRowCount() const;
hgs
parents: 12
diff changeset
    49
    
6
hgs
parents:
diff changeset
    50
    QList<HgWidgetItem*> items() const;
hgs
parents:
diff changeset
    51
    HgWidgetItem* itemByIndex(const QModelIndex &index) const;
hgs
parents:
diff changeset
    52
    HgWidgetItem* itemByIndex(const int &index) const;
hgs
parents:
diff changeset
    53
hgs
parents:
diff changeset
    54
    void setSelectionModel(QItemSelectionModel *selectionModel, const QModelIndex &defaultItem);
hgs
parents:
diff changeset
    55
    QItemSelectionModel *selectionModel() const;
hgs
parents:
diff changeset
    56
    void setSelectionMode(HgWidget::SelectionMode mode, bool resetSelection);
hgs
parents:
diff changeset
    57
    HgWidget::SelectionMode selectionMode() const;
hgs
parents:
diff changeset
    58
hgs
parents:
diff changeset
    59
    void dimensions(qreal &screenSize, qreal &worldSize);
hgs
parents:
diff changeset
    60
    Qt::Orientation orientation() const;
17
hgs
parents: 12
diff changeset
    61
    virtual void setOrientation(Qt::Orientation orientation, bool animate=true);
6
hgs
parents:
diff changeset
    62
hgs
parents:
diff changeset
    63
    // new size for the widget. calls resize.
hgs
parents:
diff changeset
    64
    void scrollToPosition(qreal value, bool animate = false);
hgs
parents:
diff changeset
    65
    virtual void scrollToPosition(const QPointF& pos, bool animate);
hgs
parents:
diff changeset
    66
    void scrollTo(const QModelIndex &index);
hgs
parents:
diff changeset
    67
hgs
parents:
diff changeset
    68
    void itemDataChanged(const QModelIndex &firstIndex, const QModelIndex &lastIndex);
hgs
parents:
diff changeset
    69
hgs
parents:
diff changeset
    70
    void addItems(int start, int end);
hgs
parents:
diff changeset
    71
    void removeItems(int start, int end);
hgs
parents:
diff changeset
    72
    void moveItems(int start, int end, int destination);
hgs
parents:
diff changeset
    73
hgs
parents:
diff changeset
    74
    bool getItemPoints(int index, QPolygonF& points);
hgs
parents:
diff changeset
    75
hgs
parents:
diff changeset
    76
    QList<QModelIndex> getVisibleItemIndices() const;
hgs
parents:
diff changeset
    77
hgs
parents:
diff changeset
    78
    virtual void itemDataChanged(const int &firstIndex, const int &lastIndex);
hgs
parents:
diff changeset
    79
hgs
parents:
diff changeset
    80
    void init(Qt::Orientation scrollDirection);
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
    void setDefaultImage(QImage defaultImage);
hgs
parents:
diff changeset
    83
hgs
parents:
diff changeset
    84
    void setItemSizePolicy(HgWidget::ItemSizePolicy policy);
hgs
parents:
diff changeset
    85
    HgWidget::ItemSizePolicy itemSizePolicy() const;
hgs
parents:
diff changeset
    86
hgs
parents:
diff changeset
    87
    void setItemSize(const QSizeF& size);
hgs
parents:
diff changeset
    88
    QSizeF itemSize() const;
hgs
parents:
diff changeset
    89
hgs
parents:
diff changeset
    90
    void setItemSpacing(const QSizeF& size);
hgs
parents:
diff changeset
    91
    QSizeF itemSpacing() const;
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
    Qt::Orientation scrollDirection() const;
hgs
parents:
diff changeset
    94
    qreal scrollPosition() const;
hgs
parents:
diff changeset
    95
12
hgs
parents: 6
diff changeset
    96
    void setHandleLongPress(bool handleLongPress);
hgs
parents: 6
diff changeset
    97
        
6
hgs
parents:
diff changeset
    98
signals:
hgs
parents:
diff changeset
    99
hgs
parents:
diff changeset
   100
    // emit this signal when scrolling. for example scrollbar can be connected to this signal.
hgs
parents:
diff changeset
   101
    void scrollPositionChanged(qreal value, bool scrollBarAnimation);
hgs
parents:
diff changeset
   102
    void centerItemChanged(const QModelIndex &index);
hgs
parents:
diff changeset
   103
    void activated(const QModelIndex &index);
hgs
parents:
diff changeset
   104
    void longPressed(const QModelIndex &index, const QPointF &coords);
hgs
parents:
diff changeset
   105
    void scrollingStarted();
hgs
parents:
diff changeset
   106
    void scrollingEnded();
hgs
parents:
diff changeset
   107
hgs
parents:
diff changeset
   108
protected slots:
hgs
parents:
diff changeset
   109
hgs
parents:
diff changeset
   110
    virtual void onScrollingStarted();
hgs
parents:
diff changeset
   111
    virtual void onScrollingEnded();
hgs
parents:
diff changeset
   112
hgs
parents:
diff changeset
   113
private slots:
hgs
parents:
diff changeset
   114
hgs
parents:
diff changeset
   115
    void updateBySpringPosition();
hgs
parents:
diff changeset
   116
    void redraw();
hgs
parents:
diff changeset
   117
    void updateLongPressVisualizer();
hgs
parents:
diff changeset
   118
hgs
parents:
diff changeset
   119
protected: // from HgMediaWallDataProvider
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
    int imageCount() const;
hgs
parents:
diff changeset
   122
    const HgImage *image(int index) const;
hgs
parents:
diff changeset
   123
    int flags(int index) const;
12
hgs
parents: 6
diff changeset
   124
    const HgImage *indicator(int flags);
6
hgs
parents:
diff changeset
   125
hgs
parents:
diff changeset
   126
protected: // events
hgs
parents:
diff changeset
   127
hgs
parents:
diff changeset
   128
    virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget);
hgs
parents:
diff changeset
   129
hgs
parents:
diff changeset
   130
    virtual void resizeEvent(QGraphicsSceneResizeEvent *event);
hgs
parents:
diff changeset
   131
hgs
parents:
diff changeset
   132
    // this needs to be implemented for gesture framework to work
hgs
parents:
diff changeset
   133
    virtual void mousePressEvent(QGraphicsSceneMouseEvent *event);
hgs
parents:
diff changeset
   134
    // From HbWidget for gestures.
hgs
parents:
diff changeset
   135
    virtual void gestureEvent(QGestureEvent *event);
hgs
parents:
diff changeset
   136
protected:
hgs
parents:
diff changeset
   137
hgs
parents:
diff changeset
   138
    virtual HgMediaWallRenderer* createRenderer(Qt::Orientation scrollDirection)=0;
hgs
parents:
diff changeset
   139
    virtual qreal getCameraDistance(qreal springVelocity);
hgs
parents:
diff changeset
   140
    virtual qreal getCameraRotationY(qreal springVelocity);
17
hgs
parents: 12
diff changeset
   141
    virtual bool handleTapAction(const QPointF& pos, HgWidgetItem* hitItem, int hitItemIndex);
hgs
parents: 12
diff changeset
   142
    virtual bool handleLongTapAction(const QPointF& pos, HgWidgetItem* hitItem, int hitItemIndex);
6
hgs
parents:
diff changeset
   143
    virtual void onScrollPositionChanged(qreal pos);
12
hgs
parents: 6
diff changeset
   144
    virtual void loadIndicatorGraphics(bool loadIfExists = false);
17
hgs
parents: 12
diff changeset
   145
    virtual bool handleTap(Qt::GestureState state, const QPointF &pos) = 0;
hgs
parents: 12
diff changeset
   146
    virtual bool handleLongTap(Qt::GestureState state, const QPointF &pos);
12
hgs
parents: 6
diff changeset
   147
    
6
hgs
parents:
diff changeset
   148
protected:
hgs
parents:
diff changeset
   149
hgs
parents:
diff changeset
   150
    enum ItemActionType
hgs
parents:
diff changeset
   151
    {
hgs
parents:
diff changeset
   152
        LongTap = 1,
hgs
parents:
diff changeset
   153
        DoubleTap,
hgs
parents:
diff changeset
   154
        NormalTap,
hgs
parents:
diff changeset
   155
        TapStart,
hgs
parents:
diff changeset
   156
        LongTapStart
hgs
parents:
diff changeset
   157
    };
hgs
parents:
diff changeset
   158
hgs
parents:
diff changeset
   159
    qreal worldWidth() const;
hgs
parents:
diff changeset
   160
    void initSpringForScrollBar();
hgs
parents:
diff changeset
   161
    void initSpringForScrolling();
hgs
parents:
diff changeset
   162
    void boundSpring();
hgs
parents:
diff changeset
   163
    bool handlePanning(QPanGesture *gesture);
hgs
parents:
diff changeset
   164
hgs
parents:
diff changeset
   165
    void selectItem(int index);
hgs
parents:
diff changeset
   166
    void updateSelectedItem();
hgs
parents:
diff changeset
   167
    void unselectItem();
hgs
parents:
diff changeset
   168
hgs
parents:
diff changeset
   169
    bool hasItemAt(const QPointF& pos);
hgs
parents:
diff changeset
   170
    HgWidgetItem* getItemAt(const QPointF& pos, int& index);
hgs
parents:
diff changeset
   171
    void startLongPressWatcher(const QPointF& pos);
hgs
parents:
diff changeset
   172
    void stopLongPressWatcher();
17
hgs
parents: 12
diff changeset
   173
    bool handleItemSelection(HgWidgetItem* item);
6
hgs
parents:
diff changeset
   174
hgs
parents:
diff changeset
   175
    virtual void updateItemSizeAndSpacing();
hgs
parents:
diff changeset
   176
    virtual QSizeF getAutoItemSize() const;
hgs
parents:
diff changeset
   177
    virtual QSizeF getAutoItemSpacing() const;
hgs
parents:
diff changeset
   178
hgs
parents:
diff changeset
   179
protected: // data
hgs
parents:
diff changeset
   180
hgs
parents:
diff changeset
   181
    QList<HgWidgetItem *> mItems;
hgs
parents:
diff changeset
   182
    //int mRowCount;
hgs
parents:
diff changeset
   183
    //int mColumnCount;
hgs
parents:
diff changeset
   184
hgs
parents:
diff changeset
   185
    //HbLabel *mLabel;
hgs
parents:
diff changeset
   186
    HgQuadRenderer *mQuadRenderer;
hgs
parents:
diff changeset
   187
    HgMediaWallRenderer *mRenderer;
hgs
parents:
diff changeset
   188
hgs
parents:
diff changeset
   189
    HgSpring mSpring;
hgs
parents:
diff changeset
   190
    HgDrag mDrag;
hgs
parents:
diff changeset
   191
hgs
parents:
diff changeset
   192
    QTime mTapDuration; // Temp hack until HbTapGesture is available
hgs
parents:
diff changeset
   193
    QTime mDoubleTapDuration;
hgs
parents:
diff changeset
   194
    int mTapCount;
hgs
parents:
diff changeset
   195
hgs
parents:
diff changeset
   196
    bool mAnimateUsingScrollBar;
hgs
parents:
diff changeset
   197
hgs
parents:
diff changeset
   198
    HgWidget::SelectionMode mSelectionMode;
hgs
parents:
diff changeset
   199
    QItemSelectionModel *mSelectionModel;
hgs
parents:
diff changeset
   200
    HgImage *mMarkImageOn;
hgs
parents:
diff changeset
   201
    HgImage *mMarkImageOff;
hgs
parents:
diff changeset
   202
hgs
parents:
diff changeset
   203
    qreal mSpringVelAtDragStart;
hgs
parents:
diff changeset
   204
    bool mDragged;
hgs
parents:
diff changeset
   205
    int mFramesDragged;
hgs
parents:
diff changeset
   206
hgs
parents:
diff changeset
   207
    HbAbstractViewItem* mHitItemView;
hgs
parents:
diff changeset
   208
    QPixmap mHitItemPixmap;
hgs
parents:
diff changeset
   209
hgs
parents:
diff changeset
   210
    HgLongPressVisualizer* mLongPressVisualizer;
hgs
parents:
diff changeset
   211
    QTimer* mLongPressTimer;
hgs
parents:
diff changeset
   212
    HgWidgetItem* mHitItem;
hgs
parents:
diff changeset
   213
    int mHitItemIndex;
hgs
parents:
diff changeset
   214
hgs
parents:
diff changeset
   215
    QPointF mOffsetAtDragStart;
hgs
parents:
diff changeset
   216
    QTime mLongTapDuration;
hgs
parents:
diff changeset
   217
    bool mScrollBarPressed;
hgs
parents:
diff changeset
   218
hgs
parents:
diff changeset
   219
    HgWidget::ItemSizePolicy mItemSizePolicy;
hgs
parents:
diff changeset
   220
    QSizeF mUserItemSize;
hgs
parents:
diff changeset
   221
    QSizeF mUserItemSpacing;
hgs
parents:
diff changeset
   222
hgs
parents:
diff changeset
   223
    Qt::Orientation mOrientation;
hgs
parents:
diff changeset
   224
    QModelIndex mDelayedScrollToIndex;
hgs
parents:
diff changeset
   225
    bool mIgnoreGestureAction;
12
hgs
parents: 6
diff changeset
   226
    bool mHandleLongPress;
17
hgs
parents: 12
diff changeset
   227
    bool mEmitScrollingEnded;
6
hgs
parents:
diff changeset
   228
};
hgs
parents:
diff changeset
   229
hgs
parents:
diff changeset
   230
#endif