summaryrefslogtreecommitdiffstats
path: root/kdeui/ktip.cpp
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /kdeui/ktip.cpp
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
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
Diffstat (limited to 'kdeui/ktip.cpp')
-rw-r--r--kdeui/ktip.cpp424
1 files changed, 424 insertions, 0 deletions
diff --git a/kdeui/ktip.cpp b/kdeui/ktip.cpp
new file mode 100644
index 000000000..b74862ced
--- /dev/null
+++ b/kdeui/ktip.cpp
@@ -0,0 +1,424 @@
+/*****************************************************************
+
+Copyright (c) 2000-2003 Matthias Hoelzer-Kluepfel <mhk@kde.org>
+ Tobias Koenig <tokoe@kde.org>
+ Daniel Molkentin <molkentin@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.
+
+******************************************************************/
+
+#include <qcheckbox.h>
+#include <qfile.h>
+#include <qhbox.h>
+#include <qlabel.h>
+#include <qlayout.h>
+#include <qpushbutton.h>
+#include <qregexp.h>
+#include <qtextstream.h>
+#include <qimage.h>
+
+#include <kaboutdata.h>
+#include <kapplication.h>
+#include <kconfig.h>
+#include <kdebug.h>
+#include <kglobal.h>
+#include <kiconloader.h>
+#include <klocale.h>
+#include <kpushbutton.h>
+#include <kseparator.h>
+#include <kstandarddirs.h>
+#include <kstdguiitem.h>
+#include <ktextbrowser.h>
+#include <kiconeffect.h>
+#include <kglobalsettings.h>
+
+#ifdef Q_WS_X11
+#include <kwin.h>
+#endif
+
+#include "ktip.h"
+
+
+KTipDatabase::KTipDatabase(const QString &_tipFile)
+{
+ QString tipFile = _tipFile;
+ if (tipFile.isEmpty())
+ tipFile = QString::fromLatin1(KGlobal::instance()->aboutData()->appName()) + "/tips";
+
+ loadTips(tipFile);
+
+ if (!mTips.isEmpty())
+ mCurrent = kapp->random() % mTips.count();
+}
+
+
+KTipDatabase::KTipDatabase( const QStringList& tipsFiles )
+{
+ if ( tipsFiles.isEmpty() || ( ( tipsFiles.count() == 1 ) && tipsFiles.first().isEmpty() ) )
+ {
+ addTips(QString::fromLatin1(KGlobal::instance()->aboutData()->appName()) + "/tips");
+ }
+ else
+ {
+ for (QStringList::ConstIterator it = tipsFiles.begin(); it != tipsFiles.end(); ++it)
+ addTips( *it );
+ }
+ if (!mTips.isEmpty())
+ mCurrent = kapp->random() % mTips.count();
+
+}
+
+void KTipDatabase::loadTips(const QString &tipFile)
+{
+ mTips.clear();
+ addTips(tipFile);
+}
+
+// if you change something here, please update the script
+// preparetips, which depends on extracting exactly the same
+// text as done here.
+void KTipDatabase::addTips(const QString& tipFile )
+{
+ QString fileName = locate("data", tipFile);
+
+ if (fileName.isEmpty())
+ {
+ kdDebug() << "KTipDatabase::addTips: can't find '" << tipFile << "' in standard dirs" << endl;
+ return;
+ }
+
+ QFile file(fileName);
+ if (!file.open(IO_ReadOnly))
+ {
+ kdDebug() << "KTipDatabase::addTips: can't open '" << fileName << "' for reading" << endl;
+ return;
+ }
+
+ QByteArray data = file.readAll();
+ QString content = QString::fromUtf8(data.data(), data.size());
+ const QRegExp rx("\\n+");
+
+ int pos = -1;
+ while ((pos = content.find("<html>", pos + 1, false)) != -1)
+ {
+ // to make translations work, tip extraction here must exactly
+ // match what is done by the preparetips script
+ QString tip = content
+ .mid(pos + 6, content.find("</html>", pos, false) - pos - 6)
+ .replace(rx, "\n");
+ if (!tip.endsWith("\n"))
+ tip += "\n";
+ if (tip.startsWith("\n"))
+ tip = tip.mid(1);
+ if (tip.isEmpty())
+ {
+ kdDebug() << "Empty tip found! Skipping! " << pos << endl;
+ continue;
+ }
+ mTips.append(tip);
+ }
+
+ file.close();
+
+}
+
+void KTipDatabase::nextTip()
+{
+ if (mTips.isEmpty())
+ return ;
+ mCurrent += 1;
+ if (mCurrent >= (int) mTips.count())
+ mCurrent = 0;
+}
+
+
+void KTipDatabase::prevTip()
+{
+ if (mTips.isEmpty())
+ return ;
+ mCurrent -= 1;
+ if (mCurrent < 0)
+ mCurrent = mTips.count() - 1;
+}
+
+
+QString KTipDatabase::tip() const
+{
+ if (mTips.isEmpty())
+ return QString::null;
+ return mTips[mCurrent];
+}
+
+KTipDialog *KTipDialog::mInstance = 0;
+
+
+KTipDialog::KTipDialog(KTipDatabase *db, QWidget *parent, const char *name)
+ : KDialog(parent, name)
+{
+ /**
+ * Parent is 0L when TipDialog is used as a mainWidget. This should
+ * be the case only in ktip, so let's use the ktip layout.
+ */
+ bool isTipDialog = (parent);
+
+ QImage img;
+ int h,s,v;
+
+ mBlendedColor = KGlobalSettings::activeTitleColor();
+ mBlendedColor.hsv(&h,&s,&v);
+ mBlendedColor.setHsv(h, int(s*(71/76.0)), int(v*(67/93.0)));
+
+ if (!isTipDialog)
+ {
+ img = QImage(locate("data", "kdewizard/pics/wizard_small.png"));
+ // colorize and check to figure the correct color
+ KIconEffect::colorize(img, mBlendedColor, 1.0);
+ QRgb colPixel( img.pixel(0,0) );
+
+ mBlendedColor = QColor(qRed(colPixel),qGreen(colPixel),qBlue(colPixel));
+ }
+
+ mBaseColor = KGlobalSettings::alternateBackgroundColor();
+ mBaseColor.hsv(&h,&s,&v);
+ mBaseColor.setHsv(h, int(s*(10/6.0)), int(v*(93/99.0)));
+
+ mTextColor = KGlobalSettings::textColor();
+
+
+ mDatabase = db;
+
+ setCaption(i18n("Tip of the Day"));
+#ifdef Q_WS_X11
+ KWin::setIcons( winId(),
+ KGlobal::iconLoader()->loadIcon( "idea", KIcon::NoGroup, 32 ),
+ KGlobal::iconLoader()->loadIcon( "idea", KIcon::NoGroup, 16 ) );
+#endif
+ QVBoxLayout *vbox = new QVBoxLayout(this, marginHint(), spacingHint());
+
+ if (isTipDialog)
+ {
+ QHBoxLayout *pl = new QHBoxLayout(vbox, 0, 0);
+
+ QLabel *bulb = new QLabel(this);
+ bulb->setPixmap(locate("data", "kdeui/pics/ktip-bulb.png"));
+ pl->addWidget(bulb);
+
+ QLabel *titlePane = new QLabel(this);
+ titlePane->setBackgroundPixmap(locate("data", "kdeui/pics/ktip-background.png"));
+ titlePane->setText(i18n("Did you know...?\n"));
+ titlePane->setFont(QFont(KGlobalSettings::generalFont().family(), 20, QFont::Bold));
+ titlePane->setAlignment(QLabel::AlignCenter);
+ pl->addWidget(titlePane, 100);
+ }
+
+ QHBox *hbox = new QHBox(this);
+ hbox->setSpacing(0);
+ hbox->setFrameStyle(QFrame::Panel | QFrame::Sunken);
+ vbox->addWidget(hbox);
+
+ QHBox *tl = new QHBox(hbox);
+ tl->setMargin(7);
+ tl->setBackgroundColor(mBlendedColor);
+
+ QHBox *topLeft = new QHBox(tl);
+ topLeft->setMargin(15);
+ topLeft->setBackgroundColor(mBaseColor);
+
+ mTipText = new KTextBrowser(topLeft);
+
+ mTipText->setWrapPolicy( QTextEdit::AtWordOrDocumentBoundary );
+ mTipText->mimeSourceFactory()->addFilePath(
+ KGlobal::dirs()->findResourceDir("data", "kdewizard/pics")+"kdewizard/pics/");
+ mTipText->setFrameStyle(QFrame::NoFrame | QFrame::Plain);
+ mTipText->setHScrollBarMode(QScrollView::AlwaysOff);
+ mTipText->setLinkUnderline(false);
+
+ QStyleSheet *sheet = mTipText->styleSheet();
+ QStyleSheetItem *item = sheet->item("a");
+ item->setFontWeight(QFont::Bold);
+ mTipText->setStyleSheet(sheet);
+ QPalette pal = mTipText->palette();
+ pal.setColor( QPalette::Active, QColorGroup::Link, mBlendedColor );
+ pal.setColor( QPalette::Inactive, QColorGroup::Link, mBlendedColor );
+ mTipText->setPalette(pal);
+
+ QStringList icons = KGlobal::dirs()->resourceDirs("icon");
+ QStringList::Iterator it;
+ for (it = icons.begin(); it != icons.end(); ++it)
+ mTipText->mimeSourceFactory()->addFilePath(*it);
+
+ if (!isTipDialog)
+ {
+ QLabel *l = new QLabel(hbox);
+ l->setPixmap(img);
+ l->setBackgroundColor(mBlendedColor);
+ l->setAlignment(Qt::AlignRight | Qt::AlignBottom);
+
+ resize(550, 230);
+ QSize sh = size();
+
+ QRect rect = KGlobalSettings::splashScreenDesktopGeometry();
+
+ move(rect.x() + (rect.width() - sh.width())/2,
+ rect.y() + (rect.height() - sh.height())/2);
+ }
+
+ KSeparator* sep = new KSeparator( KSeparator::HLine, this);
+ vbox->addWidget(sep);
+
+ QHBoxLayout *hbox2 = new QHBoxLayout(vbox, 4);
+
+ mTipOnStart = new QCheckBox(i18n("&Show tips on startup"), this);
+ hbox2->addWidget(mTipOnStart, 1);
+
+ KPushButton *prev = new KPushButton( KStdGuiItem::back(
+ KStdGuiItem::UseRTL ), this );
+ prev->setText( i18n("&Previous") );
+ hbox2->addWidget(prev);
+
+ KPushButton *next = new KPushButton( KStdGuiItem::forward(
+ KStdGuiItem::UseRTL ), this );
+ next->setText( i18n("Opposite to Previous","&Next") );
+ hbox2->addWidget(next);
+
+ KPushButton *ok = new KPushButton(KStdGuiItem::close(), this);
+ ok->setDefault(true);
+ hbox2->addWidget(ok);
+
+ KConfigGroup config(kapp->config(), "TipOfDay");
+ mTipOnStart->setChecked(config.readBoolEntry("RunOnStart", true));
+
+ connect(next, SIGNAL(clicked()), this, SLOT(nextTip()));
+ connect(prev, SIGNAL(clicked()), this, SLOT(prevTip()));
+ connect(ok, SIGNAL(clicked()), this, SLOT(accept()));
+ connect(mTipOnStart, SIGNAL(toggled(bool)), this, SLOT(showOnStart(bool)));
+
+ ok->setFocus();
+
+ nextTip();
+}
+
+KTipDialog::~KTipDialog()
+{
+ if( mInstance==this )
+ mInstance = 0L;
+}
+
+void KTipDialog::showTip(const QString &tipFile, bool force)
+{
+ showTip(kapp->mainWidget(), tipFile, force);
+}
+
+void KTipDialog::showTip(QWidget *parent, const QString &tipFile, bool force)
+{
+ showMultiTip( parent, QStringList(tipFile), force );
+}
+
+void KTipDialog::showMultiTip(QWidget *parent, const QStringList &tipFiles, bool force)
+{
+ KConfigGroup configGroup(kapp->config(), "TipOfDay");
+
+ const bool runOnStart = configGroup.readBoolEntry("RunOnStart", true);
+
+ if (!force)
+ {
+ if (!runOnStart)
+ return;
+
+ bool hasLastShown = configGroup.hasKey("TipLastShown");
+ if (hasLastShown)
+ {
+ const int oneDay = 24*60*60;
+ QDateTime lastShown = configGroup.readDateTimeEntry("TipLastShown");
+ // Show tip roughly once a week
+ if (lastShown.secsTo(QDateTime::currentDateTime()) < (oneDay + (kapp->random() % (10*oneDay))))
+ return;
+ }
+ configGroup.writeEntry("TipLastShown", QDateTime::currentDateTime());
+ kapp->config()->sync();
+ if (!hasLastShown)
+ return; // Don't show tip on first start
+ }
+
+ if (!mInstance)
+ mInstance = new KTipDialog(new KTipDatabase(tipFiles), parent);
+ else
+ // The application might have changed the RunOnStart option in its own
+ // configuration dialog, so we should update the checkbox.
+ mInstance->mTipOnStart->setChecked(runOnStart);
+
+ mInstance->show();
+ mInstance->raise();
+ }
+
+ void KTipDialog::prevTip()
+ {
+ mDatabase->prevTip();
+ mTipText->setText(QString::fromLatin1(
+ "<qt text=\"%1\" bgcolor=\"%2\">%3</qt>")
+ .arg(mTextColor.name())
+ .arg(mBaseColor.name())
+ .arg(i18n(mDatabase->tip().utf8())));
+ mTipText->setContentsPos(0, 0);
+ }
+
+ void KTipDialog::nextTip()
+ {
+ mDatabase->nextTip();
+ mTipText->setText(QString::fromLatin1("<qt text=\"%1\" bgcolor=\"%2\">%3</qt>")
+ .arg(mTextColor.name())
+ .arg(mBaseColor.name())
+ .arg(i18n(mDatabase->tip().utf8())));
+ mTipText->setContentsPos(0, 0);
+ }
+
+ void KTipDialog::showOnStart(bool on)
+ {
+ setShowOnStart(on);
+ }
+
+ void KTipDialog::setShowOnStart(bool on)
+ {
+ KConfigGroup config(kapp->config(), "TipOfDay");
+ config.writeEntry("RunOnStart", on);
+ config.sync();
+ }
+
+ bool KTipDialog::eventFilter(QObject *o, QEvent *e)
+ {
+ if (o == mTipText && e->type()== QEvent::KeyPress &&
+ (((QKeyEvent *)e)->key() == Key_Return ||
+ ((QKeyEvent *)e)->key() == Key_Space ))
+ accept();
+
+ // If the user presses Return or Space, we close the dialog as if the
+ // default button was pressed even if the KTextBrowser has the keyboard
+ // focus. This could have the bad side-effect that the user cannot use the
+ // keyboard to open urls in the KTextBrowser, so we just let it handle
+ // the key event _additionally_. (Antonio)
+
+ return QWidget::eventFilter( o, e );
+}
+
+void KTipDialog::virtual_hook( int id, void* data )
+{
+ KDialog::virtual_hook( id, data );
+}
+
+#include "ktip.moc"