/****************************************************************************
**
** 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.
**
****************************************************************************/
#include <hbgridview.h>
#include <hbgridview_p.h>
#include <hbgridlayout_p.h>
#include <hbabstractviewitem.h>
#include <hbeffect.h>
#include <hbmodeliterator.h>

#include <QGraphicsSceneMouseEvent>

/*!
 @beta
 @hbwidgets
 \class HbGridView
 \brief HbGridView implements a grid view. Data is represented by HbGridViewItem.
 HbGridView is an HbAbstractItemView implementation using the model/view design pattern. 

 Since HbGridView is derived from HbAbstractItemView it can use QAbstractItemModel-derived implementations
 (for example QStandardItemModel) as a model.

 See HbAbstractItemView for emitted signals (touch events & item activation).
 
 <b> Scrolling Directions </b>
 
 Scrolling can be set to either a \link Qt::Horizontal \endlink or \link Qt::Vertical \endlink direction.
 Items are arranged according to the scroll direction i.e Qt::Horizontal lays out items 
 horizontally and Qt::Vertical lays out items vertically.

 By default the HbScrollArea::ClampingStyle used is BounceBackClamping, the HbScrollArea::ScrollingStyle is PanOrFlick,
 scrollbars are invisible and recycling and inertia are disabled.

 The following code snippet demonstrates the use of HbGridView
 \snippet{ultimatecodesnippet/ultimatecodesnippet.cpp,21}
 */

/*!
 GridView recycling is in proto state.
 */

/*!    
  See also  HbAbstractItemView,HbAbstractViewitem,HbGridViewItem,HbScrollArea
 */

     
/*!
 Constructs a new HbGridView with \a parent.
 */
HbGridView::HbGridView(QGraphicsItem *parent) :
    HbAbstractItemView(*new HbGridViewPrivate(), new HbGridItemContainer(), new HbModelIterator(), parent)
{
    Q_D( HbGridView );
    d->q_ptr = this;
    d->init();
}

HbGridView::HbGridView(HbGridViewPrivate &dd, HbAbstractItemContainer *container, QGraphicsItem *parent) :
    HbAbstractItemView(dd, container, new HbModelIterator(), parent)
{
    Q_D( HbGridView );
    d->q_ptr = this;
    d->init();
}

HbGridView::~HbGridView()
{
}

/*!
 \property HbGridView::rowCount()
 \brief Returns the total number of rows in the view.
 \sa HbGridView::setRowCount()
 */
int HbGridView::rowCount() const
{
    Q_D(const HbGridView);
    return d->itemContainer()->rowCount();
}

/*!
 \property HbGridView::setRowCount()
 \brief Sets the total number of rows to \a rowCount.
 \sa HbGridView::rowCount()
 */
void HbGridView::setRowCount(int rowCount)
{
    Q_D(HbGridView);

    d->mVisibleIndex = d->indexInTheCenter();

    d->itemContainer()->setRowCount(rowCount);

    scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);
}

/*!
 \property HbGridView::columnCount
 \brief Returns the total number of columns in the view.
 \sa HbGridView::setColumnCount()
 */
int HbGridView::columnCount() const
{
    Q_D(const HbGridView);
    return d->itemContainer()->columnCount();
}

/*!
 \property HbGridView::setColumnCount
 \brief Sets the total number of columns to \a columnCount.
  \sa HbGridView::columnCount()
 */
void HbGridView::setColumnCount(int columnCount)
{
    Q_D(HbGridView);

    d->mVisibleIndex = d->indexInTheCenter();

    d->itemContainer()->setColumnCount(columnCount);

    scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);
}


/*!
 \property HbGridView::iconVisible()
 \brief Returns true if icons are currently displayed in GridView.
 \sa HbGridView::setIconVisible()
 */
bool HbGridView::iconVisible() const
{
    Q_D(const HbGridView);
    return d->mIconVisible;
}

/*!
 \property HbGridView::setIconVisible()
 \brief Set visibility of icons in GridView to \a visible.
        All view items are updated automatically.
 \sa HbGridView::iconVisible()
 */
void HbGridView::setIconVisible(bool visible)
{
    Q_D(HbGridView);
    d->setIconVisible(visible);
}

/*!
 \property HbGridView::textVisible()
 \brief  Returns visibility of labels in GridView.
 \sa HbGridView::setTextVisible()
 */
bool HbGridView::textVisible() const
{
    Q_D(const HbGridView);
    return d->mTextVisible;
}

/*!
 \property HbGridView::setTextVisible()
 \brief  Sets visibility of labels in GridView to \a visible.
         All view items are updated automatically.
 \sa HbGridView::textVisible()
 */
void HbGridView::setTextVisible(bool visible)
{
    Q_D(HbGridView);
    d->setTextVisible(visible);
}

/*!
 Returns item at \a row and \a column.
 */
HbAbstractViewItem *HbGridView::itemAt(int row, int column) const
{
    Q_D(const HbGridView);
   if (     row >= 0
       &&   column >= 0
       &&   column < d->itemContainer()->columnCount()
       &&   d->mModelIterator->model()) {
        int index  = row*d->itemContainer()->columnCount() + column;
        return d->itemContainer()->itemByIndex(d->mModelIterator->index(index));
   }
   return 0;
}

/*!
 Returns item at \a index.
 Ownership of the item is not transferred.

 \deprecated HbGridView::itemAt(int) const
     is deprecated. Please use HbAbstractItemView::itemByIndex(const QModelIndex &index) instead.

 \sa HbAbstractItemView::itemByIndex(const QModelIndex &index)

 */
HbAbstractViewItem *HbGridView::itemAt(int index) const
{
    Q_D(const HbGridView);

    if (d->mModelIterator->model()) {
        return d->itemContainer()->itemByIndex(d->mModelIterator->index(index));
    }
    return 0;
}

/*!
 \reimp
 */
void HbGridView::scrollTo(const QModelIndex &index, ScrollHint hint)
{
    Q_D(HbGridView);
    // always use container, event if recycling is off and all items are 
    // in container, but still aditional action is needed -
    // container::scrollTo is responsible for procesing all
    // posponed events (DelayedLayoutRequest)
    if (    d->mModelIterator->model()
        &&  index.model() == d->mModelIterator->model()) {
        d->itemContainer()->scrollTo(index, hint);
        HbAbstractItemView::scrollTo(index, hint);
    }
}

/*!
    \reimp
*/
void HbGridView::mouseMoveEvent(QGraphicsSceneMouseEvent *event)
{
    // overriding HbAbstractitemView's selection behaviour
    HbScrollArea::mouseMoveEvent( event );
    event->accept();
}

/*!
 \reimp
 */
void HbGridView::orientationAboutToBeChanged()
{
    Q_D(HbGridView);
    d->mVisibleIndex = d->indexInTheCenter();
}

/*!
 \reimp
 */
void HbGridView::orientationChanged(Qt::Orientation newOrientation)
{
    Q_D(HbGridView);
    d->mContainer->setPos(0,0);
    d->itemContainer()->orientationChanged(newOrientation);

    scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);

    d->mVisibleIndex = QModelIndex();
}

/*!
    \reimp
*/
void HbGridView::rowsInserted(const QModelIndex &parent, int start, int end)
{
    Q_D(HbGridView);

    if (parent == d->mModelIterator->rootIndex()) {
        HbAbstractItemView::rowsInserted(parent, start, end);

        bool animate = d->mEnabledAnimations & HbAbstractItemView::Appear ? d->mAnimateItems : false;
        if (animate) {
            if (d->mAppearAnimationIndexes.count()) {
                d->mAppearAnimationIndexes.clear();
            }

            for (int i = start; i <= end; i++) {
                QPersistentModelIndex index = d->mModelIterator->index(i, parent);
                HbAbstractViewItem *item = itemByIndex(index);
                if (item) {
                    d->mAppearAnimationIndexes.append(index);
                }
            }
        }
    }
}

/*!
    \reimp
*/
void HbGridView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)
{
    Q_D(HbGridView);

    if (parent == d->mModelIterator->rootIndex() && d->mModelIterator->model()) {
        for (int i = start; i <= end; i++) {
            HbAbstractViewItem* item = d->mContainer->itemByIndex(d->mModelIterator->index(i));
            if (item) {
                bool animate = d->mEnabledAnimations & HbAbstractItemView::Disappear ? d->mAnimateItems : false;
                if (animate) {
                    d->mItemsAboutToBeDeleted.append(item);
                }
            }
        }
    }
}

/*!
    \reimp
*/
void HbGridView::rowsRemoved(const QModelIndex &parent, int start, int end)
{
    Q_D(HbGridView);

    if (parent == d->mModelIterator->rootIndex()) {
        bool animate = d->mEnabledAnimations & HbAbstractItemView::Disappear ? d->mAnimateItems: false;
        if (animate) {
            for (int i = 0; i < d->mItemsAboutToBeDeleted.count(); i++) {
                QGraphicsItem *item = d->mItemsAboutToBeDeleted.at(i);
                HbEffect::cancel(item, "appear");
                HbEffect::start(item,
                                "gridviewitem", 
                                "disappear",
                                d->mContainer,
                                "animationFinished");    
            }
            d->mItemsAboutToBeDeleted.clear();
        }
        HbAbstractItemView::rowsRemoved(parent, start, end);
    }
}

/*!
    \reimp 
*/
void HbGridView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight)
{
    Q_D(const HbGridView);

    QList<HbAbstractViewItem *> items = d->mContainer->items();

    if (!items.isEmpty()
        && topLeft.parent() == d->mModelIterator->rootIndex()
        && items.first()->modelIndex().row() <= bottomRight.row()
        && topLeft.row() <= d->itemContainer()->lastValidItemIndex().row()) {
        HbAbstractItemView::dataChanged(topLeft, bottomRight);
    }
}

/*!
    This slot is connected to scrollDirectionsChanged signal emitted from HbScrollArea.
 */
void HbGridView::scrollDirectionChanged(Qt::Orientations scrollDirection)
{
    Q_D(HbGridView);
    // scroll direction changed, calculations need to be done on old value
    d->mVisibleIndex = d->indexInTheCenter((d->mScrollDirections == Qt::Vertical) 
        ? Qt::Horizontal : Qt::Vertical);
    d->mContainer->setPos(0,0);
    d->itemContainer()->scrollDirectionChanged(scrollDirection);

    scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);

    d->mVisibleIndex = QModelIndex();
}

#include "moc_hbgridview.cpp"