src/hbwidgets/sliders/hbzoomslider_p.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 17 Sep 2010 08:32:10 +0300
changeset 28 b7da29130b0e
parent 21 4633027730f5
permissions -rw-r--r--
Revision: 201035 Kit: 201037

/****************************************************************************
**
** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (developer.feedback@nokia.com)
**
** This file is part of the HbWidgets module of the UI Extensions for Mobile.
**
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser General Public
** License version 2.1 as published by the Free Software Foundation and
** appearing in the file LICENSE.LGPL included in the packaging of this file.
** Please review the following information to ensure the GNU Lesser General
** Public License version 2.1 requirements will be met:
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights.  These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at developer.feedback@nokia.com.
**
****************************************************************************/

#include "hbzoomslider_p.h"
#include "hbslider_p.h"
#include "hbnamespace_p.h"
#include "hbinstance.h"
#include "hbwidget.h"
#include "hbslidercontrol_p.h"
#include <QGraphicsSceneEvent>
#include <QGraphicsScene>
#ifdef HB_GESTURE_FW 
#include <hbtapgesture.h>
#endif

/*!
    Example usage:
    \code
    HbSlider *slider = new HbSlider(Qt::Horizontal);
    QList<HbSlider::SliderElement> sliderElements;
    sliderElements.append(HbSlider::DecreaseElement);
    sliderElements.append(HbSlider::TrackElement);
    sliderElements.append(HbSlider::IncreaseElement);
    sliderElements.append(HbSlider::IconElement);
    sliderElements.append(HbSlider::TextElement);
    slider->setElements(sliderElements);
    slider->setRange(0, 100);
    slider->setMajorTickInterval(50);
    slider->setTickPosition(Hb::SliderTicksLeft);
    // decreaseIcon is valid HbIcon
    slider->setIcon(HbSlider::DecreaseElement, decreaseIcon);
    // increaseIcon is valid HbIcon
    slider->setIcon(HbSlider:: IncreaseElement, increaseIcon);
    // icon is valid HbIcon
    slider->setIcon(HbSlider:: IncreaseElement,icon);
    slider->setText( "1%");

    \endcode

    @hbwidgets
    \class HbZoomSlider
    \brief HbZoomSlider widget provides a vertical zoom slider.

    HbZoomSlider is provided for convenience. HbZoomSlider sets appropriate
    icons, properties and provides zoom slider specific functionality like a
    zoom level indicator label and appropriate elements out of the box.
    HbZoomSlider sets HbSlider::text  and consists of following
    slider elements by default:
    \li HbSlider::IncreaseElement
    \li HbSlider::TrackElement
    \li HbSlider::DecreaseElement
    \li HbSlider::TextElement

    \image html hbzoomslider.png A vertical zoom slider.

    The elements can be changed by calling HbSlider::setElements( ) later at any time.

    \note order of element can not be changed

    Orientation of HbZoomSlider can not be changed. If orientation change is need, 
    then first create HbSlider and set needed elements.

    Note:: if setElement is called on this slider , application is reponsible for
    inconsitent UI.
*/


class HbZoomSliderPrivate : public HbSliderPrivate
{
    Q_DECLARE_PUBLIC( HbZoomSlider )

public:
    HbZoomSliderPrivate( );
    virtual ~HbZoomSliderPrivate( );
    void init( );
    // zoom slider can have default level set by Apps
    bool mDefaultSet;
    int mDefaultZoomLevel;
    void _q_resetToDefault( );
};


HbZoomSliderPrivate::HbZoomSliderPrivate( )
{
 
}


HbZoomSliderPrivate::~HbZoomSliderPrivate( )
{
}

/*!
    creates slider element and set default values
 */
void HbZoomSliderPrivate::init( )
{
    Q_Q( HbZoomSlider );
    mDefaultSet = false;
    sliderControl->setToolTipVisible(false);
    QList<HbSlider::SliderElement> elements;
    elements << HbSlider::IncreaseElement 
        << HbSlider::TrackElement 
        << HbSlider::DecreaseElement 
        << HbSlider::TextElement;
    setElements( elements );
#ifdef HB_GESTURE_FW    
    q->grabGesture(Qt::TapGesture);
#endif 

     // create element because HbSlider will not create element for NULL Icon
    // and zoom slider Icon is set in style

    if ( !elementItemMap.contains(HbSlider::IncreaseElement) ) {
        elementItemMap[HbSlider::IncreaseElement].item = 
            HbStylePrivate::createPrimitive( HbStylePrivate::P_SliderElement_increase, q);
        HbStyle::setItemName( elementItemMap[HbSlider::IncreaseElement].item, "increment-icon" );
        elementItemMap[HbSlider::IncreaseElement].type= HbStylePrivate::P_SliderElement_increase;
        elementItemMap[HbSlider::IncreaseElement].touchItem = 
            HbStylePrivate::createPrimitive( HbStylePrivate::P_SliderElement_touchincrease,q );
        HbStyle::setItemName( elementItemMap[HbSlider::IncreaseElement].touchItem, "increment-icon-toucharea" );
    }

    if ( !elementItemMap.contains(HbSlider::DecreaseElement) ) {
        elementItemMap[HbSlider::DecreaseElement].item = 
            HbStylePrivate::createPrimitive( HbStylePrivate::P_SliderElement_decrease, q);
        elementItemMap[HbSlider::DecreaseElement].type = HbStylePrivate::P_SliderElement_decrease;
        HbStyle::setItemName( elementItemMap[HbSlider::DecreaseElement].item, "decrement-icon" );
        elementItemMap[HbSlider::DecreaseElement].touchItem = HbStylePrivate::createPrimitive( HbStylePrivate::P_SliderElement_touchdecrease,q ) ;
        HbStyle::setItemName( elementItemMap[HbSlider::DecreaseElement].touchItem, "decrement-icon-toucharea" );
    }

    HbStyleOptionSlider option;
    q->initStyleOption( &option );
    option.sliderElementIcon = icons.value( HbSlider::IncreaseElement ); 
    HbStylePrivate::updatePrimitive(elementItemMap[HbSlider::IncreaseElement].item ,HbStylePrivate::P_SliderElement_increase,&option );
    option.sliderElementIcon = icons.value( HbSlider::DecreaseElement ); 
    HbStylePrivate::updatePrimitive(elementItemMap[HbSlider::DecreaseElement].item ,HbStylePrivate::P_SliderElement_decrease,&option );
    q->setFlags( QGraphicsItem::ItemIsFocusable );
    q->connect( q, SIGNAL( textClicked( ) ), q, SLOT( _q_resetToDefault( ) ) );
    q->setProperty("changeincrementState" ,false);
    q->setProperty("changedecrementState" ,false);
    q->setProperty("state", "normal");
}

/*!
    This slot will be called when ever there is click on text
    this will set zoom level to default if specified by Application
 */
void HbZoomSliderPrivate::_q_resetToDefault( )
{
    Q_Q( HbZoomSlider );
    if( mDefaultSet ) {
        q->setValue( q->defaultZoomLevel( ) );
    }
}


/*!   
    Constructs a zoom slider with \a parent.

    The orientation is \b Qt::Vertical and the slider contains increase, track, 
    decrease and text elements by default.
    \sa setOrientation( ), setElements( )
*/

HbZoomSlider::HbZoomSlider( QGraphicsItem *parent )
    : HbSlider( *new HbZoomSliderPrivate, parent )
{
    Q_D( HbZoomSlider );
    d->q_ptr = this;
    d->init( );
    // UX specifies that the default step value for zoom slider should be 10
    setSingleStep( 10 );
}

/*!
    Destroys the zoom slider.
*/
HbZoomSlider::~HbZoomSlider( )
{
}


/*!
    Returns the default Zoom Level of the zoom slider if set by application
    otherwise returns minimum value. 

    \sa setDefaultZoomLevel( )

*/
int HbZoomSlider::defaultZoomLevel( ) const
{
    Q_D( const HbZoomSlider );
    if( d->mDefaultSet ) {
         return d->mDefaultZoomLevel;
    } else {
         return minimum( );
    }
}


/*!   
    sets the default Zoom Level of the zoom slider with \a value.
    if not set minimum( ) value will be used for default value.

    \sa defaultZoomLevel( )
*/
void HbZoomSlider::setDefaultZoomLevel( int value )
{
    Q_D( HbZoomSlider );
    d->mDefaultSet=true;
    //bound check
    if( value > minimum( ) && value < maximum( ) ) {
        d->mDefaultZoomLevel=value;
    }
}


/*!   
    \reimp
    This is not supported in HbZoomSlider
 */
void HbZoomSlider::setToolTipVisible( bool /*b*/ )
{
    Q_ASSERT_X( false, "HbZoomSlider::setToolTipVisible( )", 
        "Current value display as tooltip is not supported in zoom slider" );

}

/*!
    \reimp
 */
void HbZoomSlider::mousePressEvent( QGraphicsSceneMouseEvent *event )
{
#ifndef HB_GESTURE_FW 
    Q_D( HbZoomSlider );
    if( d->elementItemMap.contains(HbSlider::IncreaseElement) ) {
        if ( d->elementItemMap[HbSlider::IncreaseElement].touchItem->isUnderMouse( ) ) {
            setProperty("changeincrementState" ,true);
            setProperty("changedecrementState" ,false);
            setProperty("state", "pressed"); 
        }
    }
    if( d->elementItemMap.contains(HbSlider::DecreaseElement) ) {
        if ( d->elementItemMap[HbSlider::DecreaseElement].touchItem->isUnderMouse( ) ) {
            setProperty("changeincrementState" ,false);
            setProperty("changedecrementState" ,true);
            setProperty("state", "pressed"); 
        }
    }
   
    HbSlider::mousePressEvent( event );
#else
    Q_UNUSED(event)
#endif 
}

/*!
    \reimp

 */
void HbZoomSlider::mouseReleaseEvent( QGraphicsSceneMouseEvent *event )
{
#ifndef HB_GESTURE_FW 
    Q_D( HbZoomSlider );
    HbSlider::mouseReleaseEvent( event );
    d->stopRepeatAction( );
    setProperty("changeincrementState" ,false);
    setProperty("changedecrementState" ,false);
    setProperty("state", "normal"); 
#else
    Q_UNUSED (event)
#endif 
}
/*!
    \reimp
 */
void HbZoomSlider::gestureEvent(QGestureEvent *event)
{ 
    Q_D(HbZoomSlider);
    //consume the event if gesture is on increment or decrement
    if (HbTapGesture *tap = qobject_cast<HbTapGesture *>(event->gesture(Qt::TapGesture))) {
        QPointF pos = event->mapToGraphicsScene(tap->position());
        switch( tap->state( ) ) {
            case Qt::GestureStarted: {
                if ( d->elementItemMap.contains (HbSlider::IncreaseElement ) ) {
                    if (d->elementItemMap[HbSlider::IncreaseElement].touchItem ) {
                        if (d->elementItemMap[HbSlider::IncreaseElement].touchItem->sceneBoundingRect().contains(pos)) {
                            setProperty("changeincrementState" ,true);
                            setProperty("changedecrementState" ,false);
                            setProperty("state", "pressed"); 

                        }
                    }
                }
                if ( d->elementItemMap.contains (HbSlider::DecreaseElement ) ) {
                    if (d->elementItemMap[HbSlider::DecreaseElement].touchItem ) {
                        if (d->elementItemMap[HbSlider::DecreaseElement].touchItem->sceneBoundingRect().contains(pos))  {
                            setProperty("changeincrementState" ,false);
                            setProperty("changedecrementState" ,true);
                            setProperty("state", "pressed"); 
                        }
                    }
                }
            }
            break;
            case Qt::GestureCanceled:
            case Qt::GestureFinished:     {       
                setProperty("changeincrementState" ,false);
                setProperty("changedecrementState" ,false);
                setProperty("state", "normal");        
                } 
            default:
                break;


        }
    }
    HbSlider::gestureEvent(event);       
}

/*!
    \reimp
 */
QVariant HbZoomSlider::itemChange( GraphicsItemChange change, const QVariant &value )
{
    Q_D( HbZoomSlider );
    switch ( static_cast<HbPrivate::HbItemChangeValues>( change ) ) {
      case ItemVisibleHasChanged:
            if( !value.toBool( ) ){
                if( d->sliderControl ){
                    d->sliderControl->setSliderDown( false );
                }
                setProperty("changeincrementState" ,false);
                setProperty("changedecrementState" ,false);
                setProperty("state", "normal");  
             }
            break;
        default:
            break;
    }
    return HbSlider::itemChange( change, value );
}

/*!
    \reimp
 */
void HbZoomSlider::initStyleOption( HbStyleOptionSlider *option ) const
{
    option->sliderType=HbStyleOptionSlider::ZoomType;
    HbSlider::initStyleOption( option );

}

/*!
    \reimp
 */
void HbZoomSlider::focusInEvent( QFocusEvent *event )
{
    Q_UNUSED( event );
    Q_D( HbZoomSlider );
    d->sliderControl->setFocus( );
}

#include "moc_hbzoomslider_p.cpp"