/****************************************************************************

**

** 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 <hbprogressbar.h>

#include <hbstyleoptionprogressbar.h>

#include "hbprogressbar_p.h"

#ifdef HB_EFFECTS

#include <hbeffect.h>

#include "hbeffectinternal_p.h"

#define HB_PRGRESSBAR_ITEM_TYPE "HB_PROGRESSBAR"

#endif

/*!

    @beta

    @hbwidgets

    \class HbProgressBar

    \brief HbProgressBar widget provides a vertical and horizontal progress bar.

    An infinite progressbar is also available.

    A progress bar is used to give the user an indication of the progress of an operation and to 

    reassure them that the application is still running.

    The progress bar uses the concept of steps. User can set it up by specifying the minimum and 

    maximum possible step values, and it will display the percentage of steps that have been completed

    when you later give it the current step value. 

    The percentage is calculated by dividing the progress (progressValue() - minimum()) divided by maximum() - minimum().

    User can specify the minimum and maximum number of steps with setMinimum() and setMaximum() APIs. 

    The current number of steps is set with setProgressValue(). 

    If minimum and maximum both are set to 0, the bar shows a busy indicator instead of a percentage of steps.

    This is useful, for example, when using ftp or http to download items when they are unable to 

    determine the size of the item being downloaded.

    ProgressBar also supports adding text . min max text pair is also supported which is commonly 

    used for progress indication for music.

    \image html hbprogressbartext.png Left Aligned Text, Min Max Text.

    Progress bar provides below signal.

    \li valueChanged(int value) Emitted when the value of the progressbar is changed.

*/

/*!

    @beta

    \fn void HbProgressBar::valueChanged(int value)

    Emitted when the value of the progressbar is changed.

*/

/*!

    @beta

    \reimp

    \fn int HbProgressBar::type() const

 */

/*!

    @beta

    \enum HbProgressBar::ProgressBarType

    This enum defines available progress bar types.

*/

/*

    HbProgressBarPrivate

    private class constructor     

*/

HbProgressBarPrivate::HbProgressBarPrivate() :

    mFrame(0),

    mTrack(0),

    mWaitTrack(0),

    mMinTextItem(0),

    mMaxTextItem(0),

    mMinMaxTextVisible(false),

    mMaximum(100),

    mMinimum(0),

    mProgressValue(0),

    mInvertedAppearance(false),

    mMinMaxTextAlignment(Qt::AlignBottom),

    mMinText(QString()),

    mMaxText(QString()),

    mOrientation(Qt::Horizontal),

{

}

/*

    HbProgressBarPrivate

    destructor     

*/

HbProgressBarPrivate::~HbProgressBarPrivate() 

{

}

/*

    \internal

    initialises progressbar

*/

void HbProgressBarPrivate::init() 

{

    Q_Q(HbProgressBar);

    HbStyle *style = qobject_cast<HbStyle*>(q->style());

    Q_ASSERT(style);

    mFrame = style->createPrimitive(HbStyle::P_ProgressBar_frame,q);

    mTrack = style->createPrimitive(HbStyle::P_ProgressBar_track,mFrame);

    mWaitTrack = style->createPrimitive(HbStyle::P_ProgressBar_waittrack,mFrame);    

    mWaitTrack->setVisible(false);

    if(q->layoutDirection() == Qt::RightToLeft) {

        q->setInvertedAppearance(true);

    }

#ifdef HB_EFFECTS

    HbEffectInternal::add(HB_PRGRESSBAR_ITEM_TYPE,"progressbar_appear", "progressbar_appear");

    HbEffectInternal::add(HB_PRGRESSBAR_ITEM_TYPE,"progressbar_disappear", "progressbar_disappear");

    HbEffectInternal::add(HB_PRGRESSBAR_ITEM_TYPE,"progressbar_progress_complete", "progressbar_progress_complete");

#endif

}

/*

    createTextPrimitives

*/

void HbProgressBarPrivate::createTextPrimitives()

{

    Q_Q(HbProgressBar);

    mMinTextItem = q->style()->createPrimitive(HbStyle::P_ProgressBar_mintext,q);

    mMaxTextItem = q->style()->createPrimitive(HbStyle::P_ProgressBar_maxtext,q);

}

    \internal

    Sets the progressbar range

*/

void HbProgressBarPrivate::setRange(int minimum, int maximum)

{

    Q_Q(HbProgressBar);

    if( minimum > maximum ){

        maximum = minimum ;

    }

    mMinimum = minimum;

    mMaximum = maximum;

    if ( mProgressValue < mMinimum){

        mProgressValue = mMinimum;

    }

    if(mProgressValue > mMaximum){

        mProgressValue = mMaximum;

    }

    if( (mMinimum == 0) && (mMaximum == 0) && (mType != HbProgressBar::RatingProgressBar) ) {

        mWaitTrack->setVisible(true);

        mTrack->setVisible(false);

    } else {

        mWaitTrack->setVisible(false);

        mTrack->setVisible(true);

    }

    q->updatePrimitives();

}

/*!

    \internal

    Sets the progressbar orientation.

    Can be either vertical or Horizontal.

*/

void HbProgressBarPrivate::setOrientation(Qt::Orientation orientation)

{

    Q_Q(HbProgressBar);

    if (mOrientation != orientation) {

        mOrientation = orientation;

        q->repolish();

        q->updatePrimitives();

    }

}

/*!

    \internal

    Private slot which delays the hiding effect.

*/

#ifdef HB_EFFECTS

void HbProgressBarPrivate::_q_delayedHide(HbEffect::EffectStatus status)

{

    Q_Q(HbProgressBar);

    if (status.reason != Hb::EffectNotStarted) {

        q->setVisible(false);

    } 

}

#endif

/*!

    Constructs a progressbar of a given \a type and \a parent. The default type is SimpleProgressBar.

    \deprecated HbProgressBar::HbProgressBar(HbProgressBar::ProgressBarType, QGraphicsItem*)

        is deprecated. Please use HbProgressBar::HbProgressBar(QGraphicsItem *parent) instead.

*/

HbProgressBar::HbProgressBar(ProgressBarType type, QGraphicsItem *parent) : 

    HbWidget(*new HbProgressBarPrivate, parent)

{    

    Q_D( HbProgressBar );

    d->q_ptr = this;

    d->init();

    d->mType = type;

}

/*!

    @beta

*/

HbProgressBar::HbProgressBar(QGraphicsItem *parent) : 

    HbWidget(*new HbProgressBarPrivate, parent)

{    

    Q_D( HbProgressBar );

    d->q_ptr = this;

    d->init();

}

/*!

    \deprecated HbProgressBar::HbProgressBar(HbProgressBarPrivate&, HbProgressBar::ProgressBarType, QGraphicsItem*)

        is deprecated. Please use HbProgressBar::HbProgressBar(HbProgressBarPrivate &dd, QGraphicsItem *parent) instead.

*/

HbProgressBar::HbProgressBar(HbProgressBarPrivate &dd, ProgressBarType type, QGraphicsItem *parent) : 

    HbWidget( dd, parent)

{   

    Q_D( HbProgressBar );

    d->init();

    d->mType = type;

}

HbProgressBar::HbProgressBar(HbProgressBarPrivate &dd, QGraphicsItem *parent) : 

    HbWidget( dd, parent)

{   

    Q_D( HbProgressBar );

    d->init();

}

/*!

    @beta

    Destructor for the progressbar.

*/

HbProgressBar::~HbProgressBar() 

{    

}

/*!

    @beta

bool HbProgressBar::invertedAppearance() const 

{

    Q_D( const HbProgressBar );

    return d->mInvertedAppearance;

}

/*!

    @beta

void HbProgressBar::setInvertedAppearance(bool inverted)

{

    Q_D( HbProgressBar );

    d->mInvertedAppearance=inverted;

    updatePrimitives();

}

/*!

    @beta

    \sa setMaximum()

*/

int HbProgressBar::maximum() const

{   

    Q_D( const HbProgressBar );

    return d->mMaximum;

}

/*!

    @beta

*/

void HbProgressBar::setMaximum(int maximum)

{

    Q_D( HbProgressBar );

    d->setRange(qMin(d->mMinimum,maximum),maximum);

}

/*!

    @beta

    \sa setMinimum()

*/

int HbProgressBar::minimum() const

{

    Q_D( const HbProgressBar );

    return d->mMinimum;

}

/*!

    @beta

*/

void HbProgressBar::setMinimum(int minimum)

{

    Q_D( HbProgressBar );

    d->setRange(minimum,qMax(d->mMaximum,minimum));

}

/*!

    @beta

    Returns the current value of the progress bar.

*/

int HbProgressBar::progressValue() const

{

    Q_D( const HbProgressBar );

    return d->mProgressValue;

}

/*!

    @beta

    \sa progressValue()

*/

void HbProgressBar::setProgressValue(int value)

{

    Q_D( HbProgressBar );

}

/*!

    @beta

    This function is provided for convenience.

    value.

*/

void HbProgressBar::setRange(int minimum, int maximum) 

{

    Q_D( HbProgressBar );

    d->setRange(minimum , maximum);

}

/*!

    @beta

*/

void HbProgressBar::setMinText(const QString &text)

{

    Q_D(HbProgressBar);

    if (d->mMinText != text) {

        d->mMinText = text;

        HbStyleOptionProgressBar progressBarOption;

        initStyleOption(&progressBarOption);

        style()->updatePrimitive(d->mMinTextItem,HbStyle::P_ProgressBar_mintext,&progressBarOption);

     }

}

/*!

    @beta

    Returns the Min Text of the progress bar.

*/

QString HbProgressBar::minText() const

{

    Q_D( const HbProgressBar );

    return d->mMinText;

}

/*!

    @beta

*/

void HbProgressBar::setMaxText(const QString &text)

{

    if (d->mMaxText != text) {

        d->mMaxText = text;

        HbStyleOptionProgressBar progressBarOption;

        initStyleOption(&progressBarOption);

        style()->updatePrimitive(d->mMaxTextItem,HbStyle::P_ProgressBar_maxtext,&progressBarOption);

    }

}

/*!

    @beta

    Returns the Max Text of the progress bar.

*/

QString HbProgressBar::maxText() const

{