/****************************************************************************
**
** 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 HbCore 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 "hbgestures_p.h"
#include "hbtapgesture.h"
#include "hbtapgesture_p.h"

#include <QPointF>
#include <QVariant>
#include <QDebug>

//#define TAPGESTURE_DEBUG
#ifndef TAPGESTURE_DEBUG
# define DEBUG if (0) qDebug
#else
# define DEBUG qDebug
#endif


HbTapGesturePrivate::HbTapGesturePrivate(): mTapStyleHint(HbTapGesture::Tap), mTimerId(0)
{
}

/*!
   @proto
   @hbcore
   \class HbTapGesture

   \brief HbTapGesture is an extension to Qt standard QTapGesture.

   HbTapGesture extends QTapGesture with additional information related
   to the tap gesture, but most important use for HbTapGesture is
   in widgets needing both tap and tap-and-hold. HbTapGesture
   provides both -- use of Qt::TapAndHoldGesture
   in conjunction with Qt::TapGesture in the same widget makes it
   difficult to handle state updates and finishes in the widget.
   HbTapGesture::tapStylehint() can be used to query whether
   the tap was a normal tap, or tap-and-hold at the time of Qt::GestureUpdated
   of Qt::GestureFinished. A gesture update will be sent at the time
   when the tap-and-hold timer triggers. No updates are sent
   of the finger movement during the tap.

   \sa QTapGesture, HbTapGesture::TapStyleHint

*/

/*!
    \brief HbTapGesture constructor
    \param parent Parent for the gesture
*/
HbTapGesture::HbTapGesture(QObject *parent)
    : QTapGesture(parent), d_ptr(new HbTapGesturePrivate)
{
    DEBUG() << "Creating" << this;
}

/*!
    \brief HbTapGesture constructor
    \param dd Custom private data
    \param parent Parent for the gesture

*/
HbTapGesture::HbTapGesture( HbTapGesturePrivate &dd, QObject *parent )
    : QTapGesture(parent), d_ptr( &dd )
{
    DEBUG() << "Creating" << this;
}

/*!
    \brief HbTapGesture destructor
*/
HbTapGesture::~HbTapGesture()
{
    DEBUG() << "Deleting" << this;
    delete d_ptr;
}

/*!
    \property startPos
    \brief Stores the starting position of the tap gesture in screen coordinates.
*/
QPointF HbTapGesture::startPos() const
{
    Q_D(const HbTapGesture);
    return d->mStartPos;
}

void HbTapGesture::setStartPos(const QPointF &startPos)
{
    Q_D(HbTapGesture);
    d->mStartPos = startPos;
}

/*!
    \property sceneStartPos
    \brief Stores the starting position of the tap gesture in scene coordinates.
*/
QPointF HbTapGesture::sceneStartPos() const
{
    Q_D(const HbTapGesture);
    return d->mSceneStartPos;
}

void HbTapGesture::setSceneStartPos(const QPointF &startPos)
{
    Q_D(HbTapGesture);
    d->mSceneStartPos = startPos;
}

/*!
    \property scenePosition
    \brief Stores the current position of the tap gesture in scene coordinates.
    \sa QTapGesture::position()
*/
QPointF HbTapGesture::scenePosition() const
{
    Q_D(const HbTapGesture);
    return d->mScenePosition;
}

void HbTapGesture::setScenePosition(const QPointF &startPos)
{
    Q_D(HbTapGesture);
    d->mScenePosition = startPos;
}

/*!
    \property tapStyleHint
    \brief Indicates whether tap is normal tap or long press.

    TapStyleHint is by default Tap and in case of long press, the gesture
    update event is sent and TapStyleHint changed to TapAndHold.
*/
HbTapGesture::TapStyleHint HbTapGesture::tapStyleHint() const
{
    Q_D(const HbTapGesture);
    return d->mTapStyleHint;
}