/*

* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU Lesser General Public License as published by

* the Free Software Foundation, version 2.1 of the License.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU Lesser General Public License for more details.

*

* You should have received a copy of the GNU Lesser General Public License

* along with this program.  If not,

* see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/".

*

* Description:

*/

#ifndef OBJECTCHARM_H_

#define OBJECTCHARM_H_

#include <QtGui>

namespace GVA {

// -------------------------------

/*!

 * Base class for object "charms".  Charms set an event filter on a particular

 * object and perform some action in response to the events sent to the object.

 * ObjectCharms automatically destroy themselves when the target object is

 * destroyed.

 */

class ObjectCharm : public QObject {

    Q_OBJECT

  public:

    ObjectCharm(QObject *object);

  private slots:

    virtual void onObjectDestroyed();

  protected:

    QObject *m_object;  // not owned

};

// -------------------------------

/*!

 * This class draws a circle in response to mouse click events on the given object.  Intended

 * for testing purposes only.

 */

class TouchCircleCharm : public ObjectCharm {

    Q_OBJECT

  public:

    TouchCircleCharm(QObject *object, QGraphicsItem *parent = 0);

    ~TouchCircleCharm();

  private slots:

    void onTimer();

  private:

    bool eventFilter(QObject *object, QEvent *event);

    class QGraphicsEllipseItem * m_item;

    class QTimer * m_timer;

};

}

#endif /* OBJECTCHARM_H_ */