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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 121 insertions, 0 deletions

diff --git a/kdeui/kwhatsthismanager.cpp b/kdeui/kwhatsthismanager.cpp
new file mode 100644
index 000000000..77c957a62
--- /dev/null
+++ b/kdeui/kwhatsthismanager.cpp
@@ -0,0 +1,121 @@
+/*  This file is part of the KDE Libraries
+ *  Copyright (C) 2004 Peter Rockai (mornfall) <mornfall@danill.sk>
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Library General Public
+ *  License as published by the Free Software Foundation; either
+ *  version 2 of the License, or (at your option) any later version.
+ *
+ *  This library 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
+ *  Library General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Library General Public License
+ *  along with this library; see the file COPYING.LIB.  If not, write to
+ *  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ *  Boston, MA 02110-1301, USA.
+ */
+#include "kwhatsthismanager_p.h"
+#include "qwhatsthis.h"
+#include <qvariant.h>
+#include <kdebug.h>
+#include <qtextedit.h>
+#include <klocale.h>
+#include <kapplication.h>
+
+KWhatsThisManager *KWhatsThisManager::s_instance = 0;
+
+class KWhatsThisUndefined : public QWhatsThis
+{
+    public:
+        KWhatsThisUndefined (QWidget *);
+        QString text (const QPoint &);
+    public slots:
+        bool clicked (const QString &);
+    protected:
+        QWidget *m_widget;
+};
+
+KWhatsThisUndefined::KWhatsThisUndefined (QWidget *w)
+    : QWhatsThis (w)
+{
+    m_widget = w;
+}
+
+QString KWhatsThisUndefined::text (const QPoint &)
+{
+    if (!m_widget)
+        return "";
+    QString txt = i18n ("<b>Not Defined</b><br>There is no \"What's This?\""
+            " help assigned to this widget. If you want to help us to "
+            " describe the widget, you are welcome to <a href=\"submit"
+            "-whatsthis\">send us your own \"What's This?\" help</a> for it.");
+    QString parent;
+    if (m_widget -> parentWidget ())
+        parent = QWhatsThis::textFor (m_widget -> parentWidget ());
+        if (parent != txt)
+            if (! parent . isEmpty ())
+                return parent;
+    return txt;
+}
+
+bool KWhatsThisUndefined::clicked (const QString& href)
+{
+    if (href == "submit-whatsthis") {
+        QWidget *w = m_widget;
+        QString body;
+        body . append ("Widget text: '" + (m_widget -> property ("text") . toString ()) + "'\n");
+        QString dsc = QString ("current --> ") + m_widget -> name ();
+        dsc . append (QString (" (") + m_widget -> className () + ")\n");
+        for (w = m_widget; w && w != m_widget -> topLevelWidget (); w = w -> parentWidget ()) {
+            dsc . append (w -> name ());
+            dsc . append (QString (" (") + w -> className () + ")\n");
+        }
+        w = m_widget -> topLevelWidget ();
+        if (w) {
+            dsc . append ("toplevel --> ");
+            dsc . append (w -> name ());
+            dsc . append (QString (" (") + w -> className () + ")\n");
+        }
+        body . append (dsc);
+        QString subj ("What's This submission: ");
+        subj . append (qApp -> argv () [0]);
+        body . append ("\nPlease type in your what's this help between these lines: "
+                "\n--%-----------------------------------------------------------------------\n"
+                "\n--%-----------------------------------------------------------------------");
+        kapp -> invokeMailer ("quality-whatsthis@kde.org", "", "", subj, body);
+    }
+    return TRUE;
+}
+
+void KWhatsThisManager::init ()
+{
+    if (s_instance)
+        return;
+    s_instance = new KWhatsThisManager;
+}
+
+KWhatsThisManager::KWhatsThisManager ()
+{
+    // go away...
+    // qApp -> installEventFilter (this);
+}
+
+bool KWhatsThisManager::eventFilter (QObject * /*o*/, QEvent *e)
+{
+    if (e -> type () == QEvent::ChildInserted) {
+        QChildEvent *ce = (QChildEvent *)e;
+        // kdDebug () << "new qobject:" << ce -> child () << endl;
+        if (ce -> child () -> isWidgetType ()) {
+            QWidget *w = (QWidget *) (ce -> child ());
+            // kdDebug () << "new qwidget:" << w << endl;
+            if (QWhatsThis::textFor (w) . isEmpty ())
+                new KWhatsThisUndefined (w);
+        }
+    }
+    return false;
+}
+
+#include "kwhatsthismanager_p.moc"
+