kworship/DesktopView.h

   1 /***************************************************************************
   2  *   This file is part of KWorship.                                        *
   3  *   Copyright 2008 James Hogan <james@albanarts.com>                      *
   4  *                                                                         *
   5  *   KWorship is free software: you can redistribute it and/or modify      *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation, either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   KWorship is distributed in the hope that it will be useful,           *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with KWorship.  If not, write to the Free Software Foundation,  *
  17  *   Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.   *
  18  ***************************************************************************/
  19
  20 #ifndef _DesktopView_h_
  21 #define _DesktopView_h_
  22
  23 /**
  24  * @file DesktopView.h
  25  * @brief Preview of the screens on the desktop.
  26  * @author James Hogan <james@albanarts.com>
  27  */
  28
  29 #include <QGraphicsView>
  30 #include <QVector>
  31
  32 /** Screens preview widget.
  33  * @todo Ensure works well with out of range screen id in multiselect mode
  34  */
  35 class DesktopView : public QGraphicsView
  36 {
  37   Q_OBJECT
  38   public:
  39
  40     /*
  41      * Constructors + destructor
  42      */
  43
  44     /// Primary constructor.
  45     DesktopView(QWidget* parent);
  46
  47     /// Destructor.
  48     ~DesktopView();
  49
  50     /*
  51      * Properties
  52      */
  53
  54     Q_PROPERTY(int selectedScreen READ selectedScreen WRITE setSelectedScreen)
  55
  56     /*
  57      * Main interface
  58      */
  59
  60     /// Find whether a screen is selected.
  61     bool isScreenSelected(int screen) const;
  62
  63     /// Find which single screen is selected.
  64     int selectedScreen() const;
  65
  66   public slots:
  67
  68     /*
  69      * Public slots
  70      */
  71
  72     /// Set the selected screen.
  73     void setSelectedScreen(int selectedScreen);
  74
  75   signals:
  76
  77     /*
  78      * Public signals
  79      */
  80
  81     /// A screen selection has changed.
  82     void screenSelected(int screen, bool selected);
  83
  84     /// Current single select screen has changed.
  85     void screenChanged(int screen);
  86
  87     /// Status message has changed.
  88     void statusChanged(QString status);
  89
  90   protected:
  91
  92     /*
  93      * Events
  94      */
  95
  96     void resizeEvent(QResizeEvent*);
  97
  98     void mousePressEvent(QMouseEvent* event);
  99
 100     void changeEvent(QEvent *event);
 101
 102   private slots:
 103
 104     /*
 105      * Private slots
 106      */
 107
 108     /// Indicates that a screen has been resized.
 109     void resizeScreen(int screen);
 110
 111   private:
 112
 113     /*
 114      * Variables
 115      */
 116
 117     /// Desktop rectangle size.
 118     QRectF m_desktopRect;
 119
 120     /// Whether to allow multiple screens to be selected.
 121     bool m_multiSelect;
 122
 123     /// Whether to allow no screen to be selected.
 124     bool m_noSelect;
 125
 126     /// Which screen is selected when in singleselect.
 127     int m_selectedScreen;
 128
 129     /// Which screens are selected when in multiselect.
 130     QVector<bool> m_selectedScreens;
 131
 132     /*
 133      * Private functions
 134      */
 135
 136     /// Setup the display.
 137     void setup();
 138
 139     /// Change selection of a screen.
 140     void selectScreen(int screen, bool newSelected);
 141
 142     /// Update a single selection status.
 143     void singleSelectRestatus();
 144 };
 145
 146 #endif // _DesktopView_h_
 147