workspace/libs/plasma/appletbrowser.h

   1 /*
   2  *   Copyright (C) 2007 Ivan Cukic <ivan.cukic+kde@gmail.com>
   3  *
   4  *   This program is free software; you can redistribute it and/or modify
   5  *   it under the terms of the GNU Library/Lesser General Public License
   6  *   version 2, or (at your option) any later version, as published by the
   7  *   Free Software Foundation
   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 Library/Lesser General Public
  15  *   License along with this program; if not, write to the
  16  *   Free Software Foundation, Inc.,
  17  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18  */
  19
  20 #ifndef APPLETBROWSERWINDOW_H_
  21 #define APPLETBROWSERWINDOW_H_
  22
  23 #include <KDE/KDialog>
  24
  25 #include <plasma/plasma_export.h>
  26
  27 namespace Plasma
  28 {
  29
  30 class Corona;
  31 class Containment;
  32 class Applet;
  33
  34 class PLASMA_EXPORT AppletBrowserWidget : public QWidget
  35 {
  36     Q_OBJECT
  37 public:
  38     AppletBrowserWidget(Plasma::Containment *containment, QWidget *parent = 0, Qt::WindowFlags f = 0);
  39     virtual ~AppletBrowserWidget();
  40
  41     void setApplication(const QString& application = QString());
  42     QString application();
  43
  44     /**
  45      * Changes the current default containment to add applets to
  46      *
  47      * @arg containment the new default
  48      */
  49     void setContainment(Plasma::Containment *containment);
  50
  51     /**
  52      * @return the current default containment to add applets to
  53      */
  54     Containment* containment() const;
  55
  56 protected Q_SLOTS:
  57     /**
  58      * Adds currently selected applets
  59      */
  60     void addApplet();
  61
  62     /**
  63      * Tracks a new running applet
  64      */
  65     void appletAdded(Plasma::Applet* applet);
  66
  67     /**
  68      * A running applet is no more
  69      */
  70     void appletDestroyed(QObject* applet);
  71
  72     /**
  73      * Destroy all applets with this name
  74      */
  75     void destroyApplets(const QString &name);
  76
  77     /**
  78      * Launches a download dialog to retrieve new applets from the Internet
  79      */
  80     void downloadWidgets();
  81
  82     /**
  83      * Opens a file dialog to open a widget from a local file
  84      */
  85     void openWidgetFile();
  86
  87 private:
  88     void init();
  89     void initRunningApplets();
  90     class Private;
  91     Private * const d;
  92 };
  93
  94 class PLASMA_EXPORT AppletBrowser: public KDialog
  95 {
  96     Q_OBJECT
  97 public:
  98     explicit AppletBrowser(Plasma::Containment *containment, QWidget *parent = 0, Qt::WindowFlags f = 0);
  99     virtual ~AppletBrowser();
 100
 101     void setApplication(const QString& application = QString());
 102     QString application();
 103
 104     /**
 105      * Changes the current default containment to add applets to
 106      *
 107      * @arg containment the new default
 108      */
 109     void setContainment(Plasma::Containment *containment);
 110
 111     /**
 112      * @return the current default containment to add applets to
 113      */
 114     Containment* containment() const;
 115
 116 private:
 117     class Private;
 118     Private * const d;
 119 };
 120
 121 } // namespace Plasma
 122
 123 #endif /*APPLETBROWSERWINDOW_H_*/