# kdeui Library API Documentation

Overview | Class Hierarchy | Classes | Classes (annotated) | Members | Source Files

# 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

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