1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (developer.feedback@nokia.com)

     6 **

     7 ** This file is part of the HbWidgets module of the UI Extensions for Mobile.

     8 **

     9 ** GNU Lesser General Public License Usage

    10 ** This file may be used under the terms of the GNU Lesser General Public

    11 ** License version 2.1 as published by the Free Software Foundation and

    12 ** appearing in the file LICENSE.LGPL included in the packaging of this file.

    13 ** Please review the following information to ensure the GNU Lesser General

    14 ** Public License version 2.1 requirements will be met:

    15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    16 **

    17 ** In addition, as a special exception, Nokia gives you certain additional

    18 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    20 **

    21 ** If you have questions regarding the use of this file, please contact

    22 ** Nokia at developer.feedback@nokia.com.

    23 **

    24 ****************************************************************************/

    25 

    26 #ifndef HBSLIDER_H

    27 #define HBSLIDER_H

    28 

    29 #include <hbwidget.h>

    30 

    31 class HbSliderPrivate;

    32 

    33 class HB_WIDGETS_EXPORT HbSlider : public HbWidget

    34 {

    35     Q_OBJECT

    36     Q_PROPERTY(int maximum READ maximum WRITE setMaximum)

    37     Q_PROPERTY(int minimum READ minimum WRITE setMinimum)

    38     Q_PROPERTY(Qt::Orientation orientation READ orientation WRITE setOrientation)

    39     Q_PROPERTY(int pageStep READ pageStep WRITE setPageStep)

    40     Q_PROPERTY(int singleStep READ singleStep WRITE setSingleStep)

    41     Q_PROPERTY(int sliderPosition READ sliderPosition WRITE setSliderPosition)

    42     Q_PROPERTY(bool tracking READ hasTracking WRITE setTracking) 

    43     Q_PROPERTY(int value READ value WRITE setValue USER true)

    44     Q_PROPERTY(Hb::SliderTickPositions tickPosition READ tickPosition WRITE setTickPosition) // does not work in armv5

    45     Q_PROPERTY(int majorTickInterval READ majorTickInterval WRITE setMajorTickInterval)

    46     Q_PROPERTY(int minorTickInterval READ minorTickInterval WRITE setMinorTickInterval)

    47     Q_PROPERTY(QStringList majorTickLabels READ majorTickLabels WRITE setMajorTickLabels)

    48     Q_PROPERTY(QStringList minorTickLabels READ minorTickLabels WRITE setMinorTickLabels)

    49     Q_PROPERTY(SnappingMode snappingMode READ snappingMode WRITE setSnappingMode)

    50     Q_PROPERTY(bool iconCheckable READ isIconCheckable WRITE setIconCheckable)

    51     Q_PROPERTY(bool iconChecked READ isIconChecked WRITE setIconChecked)

    52     Q_PROPERTY(QString text READ text WRITE setText)

    53     Q_PROPERTY(bool invertedAppearance READ invertedAppearance WRITE setInvertedAppearance)

    54     Q_PROPERTY(bool toolTipVisible READ isToolTipVisible WRITE setToolTipVisible)

    55     Q_PROPERTY(Qt::Alignment toolTipAlignment READ toolTipAlignment WRITE setToolTipAlignment)

    56     Q_PROPERTY(bool iconEnabled READ isIconEnabled WRITE setIconEnabled)

    57     Q_PROPERTY(QString handleIcon READ handleIcon WRITE setHandleIcon)

    58     Q_PROPERTY(bool trackFilled READ isTrackFilled WRITE setTrackFilled)

    59     Q_PROPERTY(QList<QVariant> sliderElements READ sliderElements WRITE setSliderElements)

    60     Q_PROPERTY(QMap elementIcons READ elementIcons WRITE setElementIcons)

    61 

    62     Q_ENUMS(SliderElement SnappingMode)

    63 

    64 public:

    65     explicit HbSlider(QGraphicsItem *parent = 0);

    66     explicit HbSlider(Qt::Orientation orientation, QGraphicsItem *parent = 0);

    67     virtual ~HbSlider();

    68 

    69     enum SliderElement {

    70         IncreaseElement,

    71         TrackElement,

    72         DecreaseElement,

    73         IconElement,

    74         TextElement

    75     };

    76 

    77     enum SnappingMode {

    78         NoSnapping,

    79         MajorTickSnapping,

    80         MinorTickSnapping

    81     };

    82 

    83     void setMaximum(int max);

    84     int maximum() const;

    85 

    86     void setMinimum(int min);

    87     int minimum() const;

    88 

    89     Qt::Orientation orientation() const;

    90 

    91     void setPageStep(int step);

    92     int pageStep() const;

    93 

    94     void setSingleStep(int step);

    95     int singleStep() const;

    96 

    97     void setSliderPosition(int pos);

    98     int sliderPosition() const;

    99 

   100     void setTracking(bool enable);

   101     bool hasTracking() const;

   102 

   103     int value() const;

   104 

   105     void setMajorTickInterval(int interval);

   106     int majorTickInterval() const;

   107 

   108     void setMinorTickInterval(int interval);

   109     int minorTickInterval() const;

   110 

   111     void setMajorTickLabels(const QStringList &majorTickLabels);

   112     QStringList majorTickLabels() const;

   113 

   114     void setMinorTickLabels(const QStringList &minorTickLabels);

   115     QStringList minorTickLabels() const;

   116 

   117     void setSnappingMode(SnappingMode mode);

   118     SnappingMode snappingMode() const;

   119 

   120     void setIconCheckable(bool checkable);

   121     bool isIconCheckable() const;

   122 

   123     void setIconChecked(bool checked);

   124     bool isIconChecked() const;

   125 

   126     QString text() const;

   127 

   128     void setInvertedAppearance(bool inverted);

   129     bool invertedAppearance() const;

   130 

   131     virtual void setToolTipVisible(bool);

   132     bool isToolTipVisible() const;

   133 

   134     Qt::Alignment toolTipAlignment() const;

   135     void setToolTipAlignment(Qt::Alignment);

   136 

   137     void setRange(int min, int max);

   138 

   139     void setTickPosition(Hb::SliderTickPositions position);

   140     Hb::SliderTickPositions tickPosition() const;

   141 

   142     void setElements(const QList<SliderElement> &elements);

   143     QList<SliderElement> elements() const;

   144 

   145     void setIcon(SliderElement element, const HbIcon &icon);

   146     HbIcon icon(SliderElement element) const;   

   147 

   148     void setElementIcon(SliderElement element, const HbIcon &icon);

   149     HbIcon elementIcon(SliderElement element) const; 

   150     

   151     void setElementIcons(const QMap<QString,QVariant> &elements);

   152     QMap<QString,QVariant> elementIcons( )const;

   153 

   154     void setSliderElements(const QList<QVariant> &elements);

   155     QList<QVariant> sliderElements() const;

   156 

   157 

   158     bool isIconEnabled() const;

   159     void setIconEnabled(bool enabled);

   160 

   161     enum { Type = Hb::ItemType_Slider };

   162     int type() const { return Type; }

   163 

   164     void setHandleIcon(const QString& handlePath );

   165     QString handleIcon() const;

   166 

   167      void setTrackFilled(bool trackVisible = true );

   168      bool isTrackFilled() const;

   169 

   170     virtual QGraphicsItem * primitive(HbStyle::Primitive primitive) const;

   171 

   172 public slots:

   173     void setOrientation(Qt::Orientation orientation);

   174     void setValue(int value);

   175     void setText(const QString &text);

   176     void updatePrimitives();

   177 

   178 signals:

   179     void valueChanged(int value);

   180     void sliderPressed();

   181     void sliderReleased();

   182     void sliderMoved(int value);

   183     void rangeChanged(int min, int max);

   184 

   185     void iconPressed();

   186     void iconReleased();

   187     void iconClicked();

   188     void iconToggled(bool checked);

   189     void textClicked(); 

   190 

   191 protected:

   192     HbSlider(HbSliderPrivate &dd, QGraphicsItem *parent);

   193     virtual void mousePressEvent(QGraphicsSceneMouseEvent *event);

   194     virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);

   195     virtual QVariant itemChange(GraphicsItemChange change, const QVariant &value);    

   196     virtual void focusInEvent(QFocusEvent *event); 

   197 

   198 

   199 

   200 private:

   201     Q_DECLARE_PRIVATE_D(d_ptr, HbSlider)

   202     Q_DISABLE_COPY(HbSlider)

   203 #ifdef HB_EFFECTS

   204     Q_PRIVATE_SLOT(d_func(), void  _q_startIconPressedEffect()) 

   205     Q_PRIVATE_SLOT(d_func(), void  _q_startIconReleasedEffect()) 

   206     Q_PRIVATE_SLOT(d_func(), void  _q_startTextClickEffect()) 

   207 #endif

   208 };

   209 

   210 #endif // HBSLIDER_H