Add an Example Applet Now Tux grins from your Taskbar ;)

1 files changed, 72 insertions, 0 deletions

diff --git a/examples/applet/simpleimpl.h b/examples/applet/simpleimpl.h
new file mode 100644
index 0000000..8459c96
--- a/dev/null
+++ b/examples/applet/simpleimpl.h
@@ -0,0 +1,72 @@
+/*
+ * You may use, modify and distribute without any limitation
+ */
+
+/**
+ * Opie and Qtopia uses a component system called QCOM
+ * which was first part of the Qt 3.0 API but was made
+ * prviate during the betas. Opie and Qtopia still use it
+ * and we're happy with it.
+ * Every starts with the QUnknownInterface. It supports functions
+ * for reference counting and the most important one
+ * is for a query. Every QCOM interface got a global unique id ( GUID,UUID )
+ * query is used to see if a interface is supported by
+ * a dynamic shared object ( dso / plugin )
+ * For tasks like loading Applications, InputMethods, Today, MenuButton,
+ * Taskbar, Style, Email Client there are specefic Interfaces you
+ * need to implement. The interfaces inherits from QUnknownInterface and
+ * you'll need inherit from the interface.
+ * As example we will use the Taskbar interface
+ */
+
+#ifndef SIMPLE_OPIE_EXAMPLE_APPLET_H
+#define SIMPLE_OPIE_EXAMPLE_APPLET_H
+
+/*
+ * The taskbar applet interfaces wants us to implement position() and applet()
+ * additionally we need to implement add(), release() and queryInterface for QUnknownInterface
+ * luckiy there is a macro for the reference counting
+ * We provide an Implementation of the interface.
+ */
+#include <qwidget.h>
+#include <qpe/taskbarappletinterface.h>
+
+
+/*
+ * Because we only draw an Icon in a fixed width and height
+ * we declare and define SimpleApplet here and you could use QLabel
+ * setPixmap or use QWidget and draw yourself.
+ * You might also want to reimplement mouse*Event to use some simple actions
+ */
+class SimpleApplet : public QWidget {
+    Q_OBJECT
+public:
+    SimpleApplet(QWidget *parent);
+    ~SimpleApplet();
+private:
+    void mousePressEvent( QMouseEvent* );
+    void paintEvent( QPaintEvent* );
+    QPixmap *m_pix;
+};
+
+class SimpleAppletImpl : public TaskbarAppletInterface {
+public:
+
+    SimpleAppletImpl();
+    virtual ~SimpleAppletImpl();
+
+    QRESULT queryInterface( const QUuid&, QUnknownInterface** );
+
+    QWidget *applet( QWidget* parent );
+    int position()const;
+
+    /*
+     * macro for reference countint
+     * if reference drops to zero
+     * delete this is called
+     */
+    Q_REFCOUNT
+};
+
+
+#endif