kwhatsthismanager.cpp
/* 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"
klocale.h
KStdAccel::name
QString name(StdAccel id)

KDE Home | KDE Accessibility Home | Description of Access Keys