workspace/plasma/shells/desktop/plasmaapp.h

   1 /*
   2  *   Copyright 2006, 2007 Aaron Seigo <aseigo@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
   6  *   published by the Free Software Foundation; either version 2,
   7  *   or (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 Library 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 PLASMA_APP_H
  21 #define PLASMA_APP_H
  22
  23 #include <QHash>
  24 #include <QList>
  25 #include <QSize>
  26 #include <QPoint>
  27
  28 #include <KUniqueApplication>
  29
  30 #include <Plasma/Plasma>
  31
  32 namespace Plasma
  33 {
  34     class AppletBrowser;
  35     class Containment;
  36     class Corona;
  37 } // namespace Plasma
  38
  39 namespace Kephal {
  40     class Screen;
  41 } // namespace Kephal
  42
  43 class DesktopView;
  44 class BackgroundDialog;
  45 class RootWidget;
  46 class PanelView;
  47 class DesktopCorona;
  48
  49 class PlasmaApp : public KUniqueApplication
  50 {
  51     Q_OBJECT
  52 public:
  53     ~PlasmaApp();
  54
  55     static PlasmaApp* self();
  56     static bool hasComposite();
  57
  58     void notifyStartup(bool completed);
  59     Plasma::Corona* corona();
  60     void showAppletBrowser(Plasma::Containment *containment);
  61
  62     /**
  63      * Creates a view for the given containment
  64      */
  65     void createDesktopView(Plasma::Containment *containment, int id = 0);
  66
  67     /**
  68      * Should be called when a panel hides or unhides itself
  69      */
  70     void panelHidden(bool hidden);
  71
  72     /**
  73      * Current desktop zoom level
  74      */
  75      Plasma::ZoomLevel desktopZoomLevel() const;
  76
  77     /**
  78      * Returns the PanelViews
  79      */
  80     QList<PanelView*> panelViews() const;
  81
  82 #ifdef Q_WS_X11
  83     Atom m_XdndAwareAtom;
  84     Atom m_XdndEnterAtom;
  85     Atom m_XdndFinishedAtom;
  86     Atom m_XdndPositionAtom;
  87     Atom m_XdndStatusAtom;
  88     Atom m_XdndVersionAtom;
  89 #endif
  90
  91 public Q_SLOTS:
  92     // DBUS interface. if you change these methods, you MUST run:
  93     // qdbuscpp2xml plasmaapp.h -o dbus/org.kde.plasma.App.xml
  94     void toggleDashboard();
  95
  96     /**
  97      * Request a zoom based on the containment
  98      */
  99     void zoom(Plasma::Containment*, Plasma::ZoomDirection);
 100
 101 protected:
 102 #ifdef Q_WS_X11
 103     PanelView *findPanelForTrigger(WId trigger) const;
 104     bool x11EventFilter(XEvent *event);
 105 #endif
 106
 107 private:
 108     PlasmaApp(Display* display, Qt::HANDLE visual, Qt::HANDLE colormap);
 109     DesktopView* viewForScreen(int screen, int desktop) const;
 110     void zoomIn(Plasma::Containment *containment);
 111     void zoomOut(Plasma::Containment *containment);
 112
 113 private Q_SLOTS:
 114     void setupDesktop();
 115     void cleanup();
 116     void containmentAdded(Plasma::Containment *containment);
 117     void syncConfig();
 118     void appletBrowserDestroyed();
 119     void createView(Plasma::Containment *containment);
 120     void panelRemoved(QObject* panel);
 121     void configDialogRemoved(QObject* configDialogRemoved);
 122     void screenRemoved(int id);
 123     void compositingChanged();
 124     void showAppletBrowser();
 125     void addContainment(Plasma::Containment *fromContainment = 0);
 126     void configureContainment(Plasma::Containment*);
 127
 128 private:
 129     DesktopCorona *m_corona;
 130     QList<PanelView*> m_panels;
 131     Plasma::AppletBrowser *m_appletBrowser;
 132     QList<DesktopView*> m_desktops;
 133     QHash<Plasma::Containment *, BackgroundDialog *> m_configDialogs;
 134     Plasma::ZoomLevel m_zoomLevel;
 135     int m_panelHidden;
 136 };
 137
 138 #endif // multiple inclusion guard