workspace/kcontrol/kthememanager/kthememanager.h

   1 // -*- Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil; tab-width: 4; -*-
   2 /*  Copyright (C) 2003 Lukas Tinkl <lukas@kde.org>
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  17 */
  18
  19 #ifndef KTHEMEMANAGER_H
  20 #define KTHEMEMANAGER_H
  21
  22 #include <kcmodule.h>
  23 #include <krun.h>
  24 #include <kservice.h>
  25 #include <kurl.h>
  26
  27 #include "ui_kthemedlg.h"
  28 #include "ktheme.h"
  29
  30 class QString;
  31
  32 class QStringList;
  33
  34 #define ORIGINAL_THEME "original" // no i18n() here!!!
  35
  36 /*
  37 class K3IconViewItem;
  38
  39 class KThemeDetailsItem: public K3IconViewItem
  40 {
  41 public:
  42     KThemeDetailsItem( K3IconView * parent, const QString & text, const QPixmap & icon, const QString & execString )
  43         : K3IconViewItem( parent, text, icon ) { m_exec = execString; }
  44     virtual ~KThemeDetailsItem() { };
  45
  46     void exec() {
  47         ( void ) new KRun( m_exec );
  48     }
  49 private:
  50     QString m_exec;
  51 };
  52 */
  53
  54
  55 class KThemeDlg : public QWidget, public Ui::KThemeDlg
  56 {
  57 public:
  58   KThemeDlg( QWidget *parent ) : QWidget( parent ) {
  59     setupUi( this );
  60   }
  61 };
  62
  63 /**
  64  *
  65  * This is the for KControl config module for installing,
  66  * creating and removing visual themes.
  67  *
  68  * @brief The Theme Manager config module.
  69  * @author Lukas Tinkl <lukas@kde.org>
  70  */
  71 class kthememanager: public KCModule
  72 {
  73     Q_OBJECT
  74 public:
  75     kthememanager( QWidget *parent, const QVariantList &args );
  76     virtual ~kthememanager();
  77
  78     /**
  79      * Called on module startup
  80      */
  81     virtual void load();
  82     /**
  83      * Called when applying the changes
  84      */
  85     virtual void save();
  86     /**
  87      * Called when the user requests the default values
  88      */
  89     virtual void defaults();
  90
  91 protected:
  92     void dragEnterEvent ( QDragEnterEvent * ev );
  93     void dropEvent ( QDropEvent * ev );
  94
  95 Q_SIGNALS:
  96     /**
  97      * Emitted when some @p urls are dropped onto the kcm
  98      */
  99     void filesDropped(const KUrl::List &urls);
 100
 101 private Q_SLOTS:
 102     /**
 103      * Install a theme from a tarball (*.kth)
 104      */
 105     void slotInstallTheme();
 106
 107     /**
 108      * Remove an installed theme
 109      */
 110     void slotRemoveTheme();
 111
 112     /**
 113      * Create a new theme
 114      */
 115     void slotCreateTheme();
 116
 117     /**
 118      * Update the theme's info and preview
 119      */
 120     void slotThemeChanged( Q3ListViewItem * item );
 121
 122     /**
 123      * Invoked when one drag and drops @p urls onto the kcm
 124      * @see signal filesDropped
 125      */
 126     void slotFilesDropped( const KUrl::List & urls );
 127     void updateButton();
 128
 129
 130     void startKonqui( const QString & url );
 131     void startBackground();
 132     void startColors();
 133     void startStyle();
 134     void startIcons();
 135     void startFonts();
 136     void startSaver();
 137
 138
 139 private:
 140     /**
 141      * List themes available in the system and insert them into the listview.
 142      */
 143     void listThemes();
 144
 145     /**
 146      * Performs the actual theme installation.
 147      */
 148     void addNewTheme( const KUrl & url );
 149
 150     /**
 151      * Perform internal initialization of paths.
 152      */
 153     void init();
 154
 155     /**
 156      * Try to find out whether a theme is installed and get its version number
 157      * @param themeName The theme name
 158      * @return The theme's version number or -1 if not installed
 159      */
 160     static float getThemeVersion( const QString & themeName );
 161
 162     void queryLNFModules();
 163
 164     /**
 165      * Updates the preview widget
 166      */
 167     void updatePreview( const QString & pixFile );
 168     bool themeExist(const QString &_themeName);
 169     KThemeDlg * dlg;
 170
 171     KTheme * m_theme;
 172     KTheme * m_origTheme;
 173 };
 174
 175 #endif