--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/hbwidgets/sliders/hbvolumeslider_p.cpp Mon Apr 19 14:02:13 2010 +0300
@@ -0,0 +1,465 @@
+/****************************************************************************
+**
+** 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 "hbvolumeslider_p.h"
+#include "hbslider_p.h"
+#include "hbnamespace_p.h"
+#include "hbslidercontrol_p_p.h"
+#include "hbinstance.h"
+#include "hbabstractbutton.h"
+#include "hbslidercontrol_p.h"
+#include "hbstyleoptionslider.h"
+#include <QGraphicsSceneEvent>
+#include <QGraphicsScene>
+#include <hbwidgetfeedback.h>
+
+/*!
+ \depricated
+ This class will be depricated
+ Use HbSlider instead
+ 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 HbVolumeSlider
+ \brief HbVolumeSlider widget provides a vertical volume slider.
+
+ HbVolumeSlider is provided for convenience. HbVolumeSlider sets appropriate
+ icons and provides volume slider specific functionality like a
+ checkable mute button and appropriate elements out of the box. HbVolumeSlider
+ consists of following slider elements by default:
+ \li HbSlider::IncreaseElement
+ \li HbSlider::TrackElement
+ \li HbSlider::DecreaseElement
+ \li HbSlider::IconElement
+
+ \image html hbvolumeslider.png A volume slider.
+
+ The elements can be changed by calling HbSlider::setElements( ) later at any time.
+
+ \note order of element can not be changed
+
+ By default HbVolumeSlider will have ticks on right side ( Hb::SliderTicksRight) .
+
+ Orientation of HbVolumeSlider can not be changed. If orientation change is needed,
+ then first create HbSlider and set needed elements.
+
+ Example usage:
+ \code
+ HbVolumeSlider *slider = new HbVolumeSlider( this );
+ connect( slider, SIGNAL( valueChanged( int ) ), receiver, SLOT( volumeSliderChanged( int ) ) );
+ connect( slider, SIGNAL( iconToggled( bool ) ), receiver, SLOT( volumeMuted( bool ) ) );
+ \endcode
+
+ Note:: if setElement is called on this slider , application is reponsible for
+ inconsitent UI.
+*/
+
+
+class HbVolumeSliderPrivate : public HbSliderPrivate
+{
+ Q_DECLARE_PUBLIC( HbVolumeSlider )
+
+public:
+ HbVolumeSliderPrivate( );
+ virtual ~HbVolumeSliderPrivate( );
+ void init( );
+ void _q_valueChanged( int value );
+ void _q_muteToggled( bool state );
+ bool currentValueVisible;
+ // store previous value for un mute
+ int previousValue;
+};
+
+
+HbVolumeSliderPrivate::HbVolumeSliderPrivate( )
+{
+
+}
+
+
+HbVolumeSliderPrivate::~HbVolumeSliderPrivate( )
+{
+}
+
+
+void HbVolumeSliderPrivate::init( )
+{
+ Q_Q( HbVolumeSlider );
+ q->connect( q, SIGNAL( valueChanged( int ) ), q, SLOT( _q_valueChanged( int ) ) );
+ q->connect( q, SIGNAL( iconToggled( bool ) ), q, SLOT( _q_muteToggled( bool ) ) );
+ QList<HbSlider::SliderElement> elements;
+ elements << HbSlider::IncreaseElement
+ << HbSlider::TrackElement
+ << HbSlider::DecreaseElement
+ << HbSlider::IconElement;
+ if( currentValueVisible )
+ elements<<HbSlider::TextElement;
+ setElements( elements );
+ // create element because HbSlider will not create element for NULL Icon
+ // and volume slider Icon is set in style
+ if ( !elementItemMap.contains(HbSlider::IncreaseElement) ) {
+ elementItemMap [HbSlider::IncreaseElement].item =
+ q->style( )->createPrimitive( HbStyle::P_SliderElement_increase, q);
+ HbStyle::setItemName( elementItemMap [HbSlider::IncreaseElement].item, "increment-icon" );
+ elementItemMap[HbSlider::IncreaseElement].type = HbStyle::P_SliderElement_increase;
+ elementItemMap [HbSlider::IncreaseElement].touchItem = q->style( )->createPrimitive( HbStyle::P_SliderElement_touchincrease, q );
+ // create touch area for increment
+ HbStyle::setItemName( elementItemMap [HbSlider::IncreaseElement].touchItem, "increment-icon-toucharea" );
+ }
+
+ if ( !elementItemMap.contains(HbSlider::DecreaseElement) ) {
+ elementItemMap[HbSlider::DecreaseElement].item =
+ q->style( )->createPrimitive( HbStyle::P_SliderElement_decrease, q );
+ elementItemMap[HbSlider::DecreaseElement].type = HbStyle::P_SliderElement_decrease;
+ HbStyle::setItemName( elementItemMap[HbSlider::DecreaseElement].item, "decrement-icon" );
+
+ // create touch area for decrement
+ elementItemMap[HbSlider::DecreaseElement].touchItem = q->style( )->createPrimitive( HbStyle::P_SliderElement_touchdecrease, q ) ;
+ HbStyle::setItemName( elementItemMap[HbSlider::DecreaseElement].touchItem, "decrement-icon-toucharea" );
+ }
+ if( !elementItemMap.contains(HbSlider::IconElement) ) {
+ elementItemMap[HbSlider::IconElement].item = q->style( )->createPrimitive( HbStyle::P_SliderElement_icon,q );
+ elementItemMap[HbSlider::IconElement].type = HbStyle::P_SliderElement_icon;
+ HbStyle::setItemName( elementItemMap[HbSlider::IconElement].item, "icon-icon" );
+ // creating a dummy button , because slider icon
+ // need to emit all signal which is emitted by button
+ // there is no need for touch item for slider icon because
+ // button can act as touch area
+ HbAbstractButton *sliderIcon = new HbAbstractButton( q );
+ elementItemMap [HbSlider::IconElement].touchItem=sliderIcon;
+ HbStyle::setItemName( sliderIcon, "icon" );
+ q->connect( sliderIcon, SIGNAL( pressed( ) ), q, SIGNAL( iconPressed( ) ) );
+ q->connect( sliderIcon, SIGNAL( released( ) ), q, SIGNAL( iconReleased( ) ) );
+ q->connect( sliderIcon, SIGNAL( clicked( ) ), q, SIGNAL( iconClicked( ) ) );
+ q->connect( sliderIcon, SIGNAL( toggled( bool ) ), q, SIGNAL( iconToggled( bool ) ) );
+
+#ifdef HB_EFFECTS
+ q->connect( sliderIcon, SIGNAL( pressed( ) ), q, SLOT( _q_startIconPressedEffect( ) ) );
+ q->connect( sliderIcon, SIGNAL( released( ) ), q,SLOT( _q_startIconReleasedEffect( ) ) );
+#endif
+ }
+
+ HbStyleOptionSlider option;
+ q->initStyleOption( &option );
+ option.sliderElementIcon = icons.value( HbSlider::IncreaseElement );
+ q->style( )->updatePrimitive( elementItemMap [HbSlider::IncreaseElement].item,HbStyle::P_SliderElement_increase,&option );
+ option.sliderElementIcon = icons.value( HbSlider::DecreaseElement );
+ q->style( )->updatePrimitive( elementItemMap[HbSlider::DecreaseElement].item,HbStyle::P_SliderElement_decrease,&option );
+ option.sliderElementIcon = icons.value( HbSlider::IconElement );
+ q->style( )->updatePrimitive( elementItemMap[HbSlider::IconElement].item,elementItemMap[HbSlider::IconElement].type,&option );
+ q->setIconCheckable( true );
+ q->setFlags( QGraphicsItem::ItemIsFocusable );
+ q->setProperty("changeincrementState" ,false);
+ q->setProperty("changedecrementState" ,false);
+ q->setProperty("state", "normal");
+}
+
+/*!
+ this slot will be called when ever slider value changes
+ This wil change icon of mute /unmute button based on slider value
+ */
+void HbVolumeSliderPrivate::_q_valueChanged( int value )
+{
+ Q_Q( HbVolumeSlider );
+ if( q->minimum( )==value ) {
+ // volume is mute
+ q->setIconChecked( true );
+ } else {
+ // unmute volume
+ q->setIconEnabled( true );
+ q->setIconChecked( false );
+ }
+}
+
+/*!
+ This slot will be called when slider value reaches to non zero to zero
+ or vice versa
+ */
+void HbVolumeSliderPrivate::_q_muteToggled( bool state )
+{
+ Q_Q( HbVolumeSlider );
+ HbStyleOptionSlider option;
+ q->initStyleOption( &option );
+ sliderControl->setPreviousValue( false , 0 );
+ if( state ) {
+ previousValue=q->value( );
+ if ( previousValue == q->minimum( ) ) {
+ // mute via drag
+ sliderControl->setPreviousValue( true , previousValue + q->singleStep( ) );
+ }
+ else {
+ //mute by clicking on mute icon
+ sliderControl->setPreviousValue( true , previousValue );
+ }
+ q->setValue( q->minimum( ) );
+ option.state |= QStyle::State_Sunken;
+ if( previousValue==q->minimum( ) ){
+ q->setIconEnabled( false );
+ }
+ } else {
+ // If Icon is toggled by pressing on it
+ sliderControl->setPreviousValue( false , 0 );
+ if( q->value( )==q->minimum( ) ) {
+ q->setValue( previousValue );
+ }
+ option.state&= ~( QStyle::State_Sunken );
+ }
+ option.sliderElementIcon = icons.value( HbSlider::IconElement );
+ q->style( )->updatePrimitive( elementItemMap[HbSlider::IconElement].item,HbStyle::P_SliderElement_icon,&option );
+
+}
+
+
+/*!
+ \deprecated HbVolumeSlider::HbVolumeSlider( bool currentValueVisible,QGraphicsItem *parent )
+ is deprecated. Please use HbSlider instead
+
+ The orientation is \b Qt::Vertical and the slider contains increase, track,
+
+ decrease and icon elements by default.
+
+ \sa setOrientation( ), setElements( )
+
+ show current value if \a currentValueVisible is true
+*/
+HbVolumeSlider::HbVolumeSlider( bool currentValueVisible,QGraphicsItem *parent )
+ : HbSlider( *new HbVolumeSliderPrivate, parent )
+{
+ Q_D( HbVolumeSlider );
+ d->q_ptr = this;
+ d->currentValueVisible = currentValueVisible;
+ d->init( );
+ // The default values for volume slider are specified by UX
+ setRange( 0,100 );
+ setSingleStep( 10 );
+ setMajorTickInterval( 10 );
+ setSliderPosition( 80 );
+ setTickPosition( Hb::SliderTicksRight );
+ updatePrimitives( );
+}
+
+/*!
+ Destroys the volume slider.
+*/
+HbVolumeSlider::~HbVolumeSlider( )
+{
+}
+
+
+/*!
+ \deprecated HbVolumeSlider::setCurrentValueVisible( bool visible )
+ is deprecated. Please use HbSlider instead
+ Sets whether the text element is visible.
+
+ \sa isCurrentValueVisible( )
+*/
+void HbVolumeSlider::setCurrentValueVisible( bool visible )
+{
+ Q_D( HbVolumeSlider );
+ if( visible != d->currentValueVisible ) {
+ // add/delete text element
+ d->currentValueVisible = visible;
+ QList<HbSlider::SliderElement> elements;
+ elements << HbSlider::IncreaseElement
+ << HbSlider::TrackElement
+ << HbSlider::DecreaseElement
+ << HbSlider::IconElement;
+ if( visible ) {
+ elements<<HbSlider::TextElement;
+ }
+ //reset all value specified by UX
+ d->setElements( elements );
+ setRange( 0,100 );
+ setSingleStep( 10 );
+ setMajorTickInterval( 10 );
+ setSliderPosition( 80 );
+ setTickPosition( Hb::SliderTicksRight );
+ updatePrimitives( );
+ }
+}
+
+
+/*!
+ \deprecated HbVolumeSlider::isCurrentValueVisible( ) const
+ is deprecated. Please use HbSlider instead
+ Returns \c true whether the text element is visible.
+
+ The default value is \c false.
+
+ \sa setCurrentValueVisible( )
+*/
+bool HbVolumeSlider::isCurrentValueVisible( ) const
+{
+ Q_D( const HbVolumeSlider );
+ return d->currentValueVisible ;
+}
+
+/*!
+ \deprecated HbVolumeSlider::setToolTipVisible( bool b )
+ is deprecated. Please use HbSlider instead
+ \reimp
+
+ This is not supported in HbVolumeSlider
+ */
+void HbVolumeSlider::setToolTipVisible( bool /*b*/ )
+{
+ Q_ASSERT_X( false, "HbZoomSlider::setToolTipVisible( )",
+ "Current value display as tooltip is not supported in volume slider" );
+}
+
+/*!
+ \reimp
+ unmute the volume to previous store value in case unmute happens
+ by clicking increment/decrement icon
+ */
+void HbVolumeSlider::mousePressEvent( QGraphicsSceneMouseEvent *event )
+{
+ Q_D( HbVolumeSlider );
+ if( d->elementItemMap.contains(HbSlider::IncreaseElement) ) {
+ if ( d->elementItemMap[HbSlider::IncreaseElement].touchItem->isUnderMouse( ) ) {
+ d->pressOnIncrement = true;
+ HbWidgetFeedback::triggered( d->sliderControl, Hb::InstantPressed, Hb::ModifierSliderElement );
+ event->accept( );
+ // if volume was mute
+ if( isIconChecked( ) ){
+ // take to previous value and increase one step
+ setValue( d->previousValue+singleStep( ) );
+ // start timer for repeat action
+ d->sliderControl->setRepeatAction(
+ HbAbstractSliderControl::SliderSingleStepAdd, d->sliderControl->maximum( ) );
+ } else {// simply increase by one step
+ d->startIncrementing( );
+ }
+ setProperty("changeincrementState" ,true);
+ setProperty("changedecrementState" ,false);
+ setProperty("state", "pressed");
+ return;
+ }
+ }
+ if( d->elementItemMap.contains(HbSlider::DecreaseElement) ) {
+ if ( d->elementItemMap[HbSlider::DecreaseElement].touchItem->isUnderMouse( ) ) {
+ d->pressOnIncrement = false;
+ HbWidgetFeedback::triggered( d->sliderControl, Hb::InstantPressed, Hb::ModifierSliderElement );
+ event->accept( );
+ if( isIconChecked( ) ){
+ //set value to previous value and decrement by one step
+ setValue( d->previousValue-singleStep( ) );
+ if( value( )==minimum( ) ){
+ d->previousValue = value( );
+ setIconEnabled( false );
+ }
+ //start timer for repeat action
+ d->sliderControl->setRepeatAction(
+ HbAbstractSliderControl::SliderSingleStepSub, d->sliderControl->minimum( ) );
+ } else {
+ d->startDecrementing( );
+ }
+ setProperty("changeincrementState" ,false);
+ setProperty("changedecrementState" ,true);
+ setProperty("state", "pressed");
+ return;
+ }
+ }
+ HbSlider::mousePressEvent( event );
+ }
+
+/*!
+ \reimp
+ stop the timer and change image for increment element /decrement element
+ */
+void HbVolumeSlider::mouseReleaseEvent( QGraphicsSceneMouseEvent *event )
+{
+ Q_D( HbVolumeSlider );
+ HbSlider::mouseReleaseEvent( event );
+ d->stopRepeatAction( );
+ setProperty("state", "normal");
+}
+
+/*!
+ \reimp
+ */
+QVariant HbVolumeSlider::itemChange( GraphicsItemChange change, const QVariant &value )
+{
+ Q_D( HbVolumeSlider );
+ switch ( static_cast<HbPrivate::HbItemChangeValues>( change ) ) {
+ case ItemVisibleHasChanged:
+ if( !value.toBool( ) ){
+ d->stopRepeatAction( );
+ 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 HbVolumeSlider::initStyleOption( HbStyleOptionSlider *option ) const
+{
+ option->sliderType=HbStyleOptionSlider::VolumeType;
+ HbSlider::initStyleOption( option );
+
+}
+
+/*!
+ \reimp
+ */
+void HbVolumeSlider::focusInEvent( QFocusEvent* /*event*/ )
+{
+ Q_D( HbVolumeSlider );
+ d->sliderControl->setFocus( );
+}
+
+#include "moc_hbvolumeslider_p.cpp"
+
+
+