git.maemo.org Git - situare/blob - src/ui/indicatorbutton.h

   1 /*
   2     Situare - A location system for Facebook
   3     Copyright (C) 2010  Ixonos Plc. Authors:
   4
   5         Katri Kaikkonen - katri.kaikkonen@ixonos.com
   6         Kaj Wallin - kaj.wallin@ixonos.com
   7         Sami Rämö - sami.ramo@ixonos.com
   8
   9     Situare is free software; you can redistribute it and/or
  10     modify it under the terms of the GNU General Public License
  11     version 2 as published by the Free Software Foundation.
  12
  13     Situare is distributed in the hope that it will be useful,
  14     but WITHOUT ANY WARRANTY; without even the implied warranty of
  15     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16     GNU General Public License for more details.
  17
  18     You should have received a copy of the GNU General Public License
  19     along with Situare; if not, write to the Free Software
  20     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
  21     USA.
  22 */
  23
  24 #ifndef INDICATORBUTTON_H
  25 #define INDICATORBUTTON_H
  26
  27 #include <QMouseEvent>
  28 #include <QTimer>
  29 #include <QToolButton>
  30 #include <QWidget>
  31
  32 /**
  33  * @brief Indicator button class
  34  *
  35  * @author Katri Kaikkonen - katri.kaikkonen (at) ixonos.com
  36  * @author Sami Rämö - sami.ramo (at) ixonos.com
  37  */
  38 class IndicatorButton : public  QToolButton
  39 {
  40     Q_OBJECT
  41
  42 public:
  43     /**
  44      * @brief Constructor
  45      *
  46      * @param parent Parent widget
  47      */
  48     IndicatorButton(QWidget *parent = 0);
  49
  50     /**
  51      * @brief Desctructor
  52      */
  53     ~IndicatorButton();
  54
  55 /*******************************************************************************
  56  * BASE CLASS INHERITED AND REIMPLEMENTED MEMBER FUNCTIONS
  57  ******************************************************************************/
  58 protected:
  59     /**
  60      * @brief Event handler for mouse move events
  61      *
  62      * @param event Mouse event
  63      */
  64     void mouseMoveEvent(QMouseEvent *event);
  65
  66     /**
  67      * @brief Event handler for mouse press events
  68      *
  69      * @param event Mouse event
  70      */
  71     void mousePressEvent(QMouseEvent *event);
  72
  73     /**
  74      * @brief Event handler for mouse release events
  75      *
  76      * @param event Mouse event
  77      */
  78     void mouseReleaseEvent(QMouseEvent *event);
  79
  80     /**
  81      * @brief Event handler for paint events
  82      *
  83      * Paints the button and its icon
  84      * @param event Paint event
  85      */
  86     void paintEvent(QPaintEvent *event);
  87
  88 /*******************************************************************************
  89  * MEMBER FUNCTIONS AND SLOTS
  90  ******************************************************************************/
  91 public slots:
  92     /**
  93      * @brief Relative position of the event inside the widget
  94      */
  95     const QPoint& eventPosition();
  96
  97     /**
  98      * @brief Sets direction information for the distance indicator button
  99      *
 100      * Paints the button and its icon
 101      *
 102      * @param direction Direction to the GPS position (in degrees)
 103      * @param draw True if direction triangle should be drawn
 104      */
 105     void setDirection(qreal direction, bool draw);
 106
 107 /*******************************************************************************
 108  * SIGNALS
 109  ******************************************************************************/
 110 signals:
 111     /**
 112      * @brief Automatic centering setting changed by user
 113      *
 114      * @param enabled True if automatic centering is enabled, otherwise false
 115      */
 116     void autoCenteringTriggered(bool enabled);
 117
 118 /*******************************************************************************
 119  * DATA MEMBERS
 120  ******************************************************************************/
 121 private:
 122     bool m_drawTriangle;                    ///< Should the direction triange be drawn
 123
 124     qreal m_direction;                      ///< Direction to the GPS position (in degrees)
 125
 126     QColor *m_normalColor;                  ///< Normal background color
 127
 128     QLinearGradient *m_selectedGradient;    ///< Selected background
 129
 130     QPixmap m_indicatorLeds[2];             ///< Placeholder for images
 131
 132     QPoint m_dragPosition;                  ///< Location from where the widget is grabbed
 133     QPoint m_eventPosition;                 ///< Position of mousePressEvent
 134 };
 135
 136 #endif // INDICATORBUTTON_H