--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ginebra2/Charms/ObjectCharm.h	Fri Aug 06 17:23:08 2010 -0400
@@ -0,0 +1,72 @@
+/*
+* 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_ */