kdeui Library API Documentation

ktip.h

00001 /*****************************************************************
00002 
00003 Copyright (c) 2000, 2001 Matthias Hoelzer-Kluepfel
00004                          Tobias Koenig <tokoe82@yahoo.de>
00005 
00006 Permission is hereby granted, free of charge, to any person obtaining a copy
00007 of this software and associated documentation files (the "Software"), to deal
00008 in the Software without restriction, including without limitation the rights
00009 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
00010 copies of the Software, and to permit persons to whom the Software is
00011 furnished to do so, subject to the following conditions:
00012 
00013 The above copyright notice and this permission notice shall be included in
00014 all copies or substantial portions of the Software.
00015 
00016 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
00017 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
00018 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
00019 AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
00020 AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
00021 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
00022 
00023 ******************************************************************/
00024 
00025 #ifndef __K_TIP_H__
00026 #define __K_TIP_H__
00027 
00028 #include <qstringlist.h>
00029 
00030 #include <kdialog.h>
00031 
00032 class QCheckBox;
00033 
00034 class KTextBrowser;
00035 
00054 class KTipDatabase
00055 {
00056 public:
00065     KTipDatabase(const QString &tipFile = QString::null);
00066 
00070     QString tip() const;
00071 
00075     void nextTip();
00076 
00080     void prevTip();
00081 
00082 private:
00083     void loadTips(const QString &tipFile);
00084 
00085     QStringList tips;
00086 
00087     int current;
00088     class KTipDatabasePrivate;
00089     KTipDatabasePrivate *d;
00090 };
00091 
00099 class KTipDialog : public KDialog
00100 {
00101     Q_OBJECT
00102 public:
00110     KTipDialog(KTipDatabase *db, QWidget *parent = 0, const char *name = 0);
00111     ~KTipDialog();
00127     static void showTip(QWidget *parent, const QString &tipFile = QString::null, bool force=false);
00128 
00135     static void showTip(const QString &tipFile = QString::null, bool force = false);
00136 
00143     static void setShowOnStart(bool show);
00144 
00145 protected:
00146     bool eventFilter(QObject *, QEvent *);
00147     virtual void virtual_hook( int id, void* data );
00148 
00149 private slots:
00150     void nextTip();
00151     void prevTip();
00152     void showOnStart(bool);
00153 
00154 private:
00155     KTipDatabase *_database;
00156 
00157     QCheckBox *_tipOnStart;
00158     KTextBrowser *_tipText;
00159 
00160     class KTipDialogPrivate;
00161     KTipDialogPrivate *d;
00162 
00163     static KTipDialog *_instance;
00164 
00165         QColor _baseColor, _blendedColor, _textColor;
00166 };
00167 
00168 #endif
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.5.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Jan 28 12:57:49 2004 by doxygen 1.3.4 written by Dimitri van Heesch, © 1997-2001