Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 121 insertions, 0 deletions

diff --git a/kicker/libkicker/kickertip.h b/kicker/libkicker/kickertip.h
new file mode 100644
index 000000000..7211012fb
--- /dev/null
+++ b/kicker/libkicker/kickertip.h
@@ -0,0 +1,121 @@
+/*****************************************************************
+
+Copyright (c) 2004 Zack Rusin <zrusin@kde.org>
+                   Sami Kyostil <skyostil@kempele.fi>
+                   Aaron J. Seigo <aseigo@kde.org>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+******************************************************************/
+
+#ifndef KICKER_TIP_H
+#define KICKER_TIP_H
+
+#include <qbitmap.h>
+#include <qpixmap.h>
+#include <qtimer.h>
+#include <qwidget.h>
+
+#include <kpanelapplet.h>
+
+class QMimeSourceFactory;
+class QPaintEvent;
+class QSimpleRichText;
+class QTimer;
+
+class KDE_EXPORT KickerTip : public QWidget
+{
+    Q_OBJECT
+
+public:
+    enum MaskEffect { Plain, Dissolve };
+
+    struct Data
+    {
+            QString message;
+            QString subtext;
+            QPixmap icon;
+            KickerTip::MaskEffect maskEffect;
+            int duration;
+            KPanelApplet::Direction direction;
+
+            // do NOT delete this in the client!
+            QMimeSourceFactory* mimeFactory;
+    };
+
+    class KDE_EXPORT Client
+    {
+        public:
+            virtual void updateKickerTip(KickerTip::Data&) = 0;
+            void updateKickerTip() const;
+    };
+
+    static KickerTip* the();
+    static void enableTipping(bool tip);
+    static bool tippingEnabled();
+
+    void untipFor(const QWidget* w);
+    bool eventFilter(QObject *o, QEvent *e);
+
+protected:
+    KickerTip(QWidget * parent);
+    ~KickerTip();
+
+    void paintEvent(QPaintEvent * e);
+    void mousePressEvent(QMouseEvent * e);
+
+    void plainMask();
+    void dissolveMask();
+
+    void displayInternal();
+    void hide();
+
+    void tipFor(const QWidget* w);
+    bool isTippingFor(const QWidget* w) const;
+
+protected slots:
+    void tipperDestroyed(QObject* o);
+    void internalUpdate();
+    void display();
+
+private:
+    QBitmap m_mask;
+    QPixmap m_pixmap;
+    QPixmap m_icon;
+    MaskEffect m_maskEffect;
+    QSimpleRichText* m_richText;
+    QMimeSourceFactory* m_mimeFactory;
+
+    int m_dissolveSize;
+    int m_dissolveDelta;
+    KPanelApplet::Direction m_direction;
+
+    QTimer m_timer;
+    QTimer m_frameTimer;
+    bool m_dirty;
+    bool m_toolTipsEnabled;
+
+    const QWidget* m_tippingFor;
+
+    static KickerTip* m_self;
+    static int m_tippingEnabled;
+
+    friend class KickerTip::Client;
+};
+
+#endif