workspace/plasma/shells/desktop/desktopview.h

   1 /*
   2  *   Copyright 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 DESKTOPVIEW_H
  21 #define DESKTOPVIEW_H
  22
  23 #include <Plasma/Plasma>
  24 #include <Plasma/View>
  25
  26 namespace Plasma
  27 {
  28     class Containment;
  29 } // namespace Plasma
  30
  31 namespace Kephal
  32 {
  33     class Screen;
  34 } // namespace Kephal
  35
  36 class DashboardView;
  37
  38 class DesktopView : public Plasma::View
  39 {
  40     Q_OBJECT
  41
  42 public:
  43     DesktopView(Plasma::Containment *containment, int id, QWidget *parent);
  44     ~DesktopView();
  45
  46     /**
  47      * Returns whether or not the dashboard view is visible
  48      */
  49     bool isDashboardVisible() const;
  50
  51 public slots:
  52     /**
  53      * zoom in towards the given containment.
  54      * if toContainment is null, the current containment is used instead.
  55      * zooming in also sets toContainment as current.
  56      */
  57     void zoomIn(Plasma::ZoomLevel zoomLevel);
  58     void zoomOut(Plasma::ZoomLevel zoomLevel);
  59     void toggleDashboard();
  60     void screenResized(Kephal::Screen *);
  61     void screenMoved(Kephal::Screen *);
  62     void adjustSize();
  63
  64     void screenOwnerChanged(int wasScreen, int isScreen, Plasma::Containment* containment);
  65
  66     /**
  67      * switch to the "next" available containment on the corona.
  68      */
  69     void nextContainment();
  70
  71     /**
  72      * switch to the "previous" available containment on the corona.
  73      */
  74     void previousContainment();
  75
  76     /**
  77      * Sets the containment for this view, which will also cause the view
  78      * to track the geometry of the containment.
  79      *
  80      * @arg containment the containment to center the view on
  81      */
  82     void setContainment(Plasma::Containment *containment);
  83
  84 protected:
  85     void wheelEvent(QWheelEvent *event);
  86     void drawBackground(QPainter *painter, const QRectF &rect);
  87
  88 private:
  89     DashboardView *m_dashboard;
  90     bool m_dashboardFollowsDesktop;
  91
  92     //FIXME: duplicated from containment_p.h
  93     //(but with a bigger margin to make room even for very big panels)
  94     static const int TOOLBOX_MARGIN = 400;
  95 };
  96
  97 #endif // multiple inclusion guard