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

**

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

#include "hbdataformmodelitem_p.h"

#include "hbdataformviewitem_p.h"

#include "hbdataform_p.h"

#include "hbdatagroup_p.h"

#include "hbtapgesture.h"

#ifdef HB_EFFECTS

#include "hbeffect.h"

#include "hbeffectinternal_p.h"

#define HB_DATAFORMVIEWITEM_TYPE "HB_DATAFORMVIEWITEM"

#endif

/*!

    @beta

    @hbwidgets

    \class HbDataFormViewItem represents an item/view in HbDataForm. Each HbDataFormModelItem

    added inside a model is represented using HbDataFormViewItem instance.

    HbDataFormViewItem have different visualization based upon the 

    HbDataFormModelItem::DataItemType:

    - FormPageItem: This type does not have any visualization. Whatever QString is passed while

        creating HbDataFormModelItem, is added in a combo box at the top level view. User can 

        switch between different form page using this combo.

    - GroupItem: A visualization is created for this type. Visualization includes +/- icon and 

        group heading. User can expand and collapse the group by clicking any where in 

        HbDataFormViewItem of this type. Whatever QString is passed while creating

        HbDataFormModelItem for this type is set as a group heading.

    - GroupPageItem: This type does not have any visualization. Whatever QString is passed while

        creating HbDataFormModelItem, is added in a group combo box. User can switch between 

        different group page using this combo.

    - DataItems: Any type other then FormPageItem, GroupItem and GroupPageItem is treated as

        a data item. Data item contains label and the content widget. Data item content

        widget can be set using HbDataFormModelItem::ItemTypeRole and label of data items

        can be set using HbDataFormModelItem::LabelRole. Data items can not have any 

        children. They are always placed at the leaf.

    If HbDataFormViewItem represents a GroupItem then it can be expanded and collapsed. 

    If group is expanded then all the child items are shown.

    If user wants to create a custom data item then he has to derive from this class and set that

    as a protoype for HbDataForm using HbAbstractItemView::setItemPrototype API. While creating

    data for custom data items user should pass value greater than or equal to 

    DataItemType::CustomItemBase. When visualization is created and if data item type is

    custom item then createCustomWidget() is called. User has to override this API and pass the

    custom widget which he wants to show in data item. Below is the code snippet:

    \code

    //Derive a class from HbDataFormViewItem

    class DataFormCustomItem : public HbDataFormViewItem

    {

        Q_OBJECT

    public:

        DataFormCustomItem(QGraphicsItem *parent);

        ~DataFormCustomItem();

        virtual HbAbstractViewItem* createItem()

        {

            return new DataFormCustomItem(*this);

        }

    protected:

        //Override createCustomWidget API

        virtual HbWidget* createCustomWidget()

        {

            HbDataFormModelItem::DataItemType itemType = static_cast<HbDataFormModelItem::DataItemType>(

            modelIndex().data(HbDataFormModelItem::ItemTypeRole).toInt());

            switch(itemType){

                case HbDataFormModelItem::CustomItemBase:{

                    //Create widget which you want for this data item

                    HbWidget *widget = new HbWidget();

                    QGraphicsLinearLayout *layout = new QGraphicsLinearLayout(Qt::Horizontal);

                    widget->setLayout(layout);

                    HbLineEdit *button1 = new HbLineEdit();

                    layout->addItem(button1);

                    HbLabel *label = new HbLabel(QString("testing label"));

                    layout->addItem(label);

                    //Return the custom widget created

                    return widget;

                }

                //Some other cases can also be added if there are more than one custom data item

            default:

                return 0;

            }

        }

    private:

        Q_DECLARE_PRIVATE_D(d_ptr, DataFormCustomItem)

    };

    //some were is your application

    ContentWidget::ContentWidget(QGraphicsItem *parent)

    {

        HbDataForm *form = new HbDataForm();

        DataFormCustomItem *myPrototype = new DataFormCustomItem();

        form->setItemPrototype(myPrototype);

    }

    \endcode

    The signals emitted by this class are:

    \li itemShown(const QModelIndex&) This signal is emitted when ever this item becomes visible.

    Refer HbDataForm documentation for sample code.

    \sa HbDataForm, HbDataFormModel, HbDataFormModelItem

*/

/*!

    Constructs HbDataFormViewItem with given \a parent.

    \param parent parent .

 */

HbDataFormViewItem::HbDataFormViewItem(QGraphicsItem *parent):

    HbAbstractViewItem(*new HbDataFormViewItemPrivate(this), parent)

{

    Q_D(HbDataFormViewItem);

    d->q_ptr = this;

}

/*!

    Destructs the HbDataFormViewItem.

*/

HbDataFormViewItem::~HbDataFormViewItem()

{

}

/*!

    \reimp

    Creates HbDataFormViewItem. This function is called form HbAbstractItemContainer 

    when model is getting parsed for creating items. 

 */

HbAbstractViewItem* HbDataFormViewItem::createItem()

{

    return new HbDataFormViewItem(*this);

}

/*!

    \reimp

    Returns true if \a model index is supported by HbDataFormViewItem, otherwise returns false.

    This function is called for every item on the prototype list (, if several prototypes exist)

    until item is found, which can create item for \a index. The prototype list is gone 

    through from end to the beginning. 

    \sa HbAbstractItemView::setItemPrototype(HbAbstractViewItem *prototype), HbAbstractItemView::setItemPrototype(const QList<HbAbstractViewItem *> &prototypes)

 */

bool HbDataFormViewItem::canSetModelIndex(const QModelIndex &index) const

{

    HbDataFormModelItem::DataItemType itemType = 

        static_cast<HbDataFormModelItem::DataItemType>(

        index.data(HbDataFormModelItem::ItemTypeRole).toInt());

    if( ( itemType >= HbDataFormModelItem::SliderItem 

        && itemType < HbDataFormModelItem::CustomItemBase ) ) {

        return true;

    } else {

        return false;

    }

}

/*!

    \reimp

    Updates child graphics items to represent current state and content. In case when 

    HbDataFormViewItem represents data item and DataItemType is set to custom item, then 

    createCustomWidget is called. User can override createCustomWidget and can pass his own

    custom widget.

    \sa createCustomWidget

*/

void HbDataFormViewItem::updateChildItems()

{

    Q_D( HbDataFormViewItem );

    d->init();

    //this will create the visualization for all standard data items

    d->createContentWidget( );

    //set the label in data iem

    QString itemLabel = d->mIndex.data( HbDataFormModelItem::LabelRole ).toString( );

    d->setLabel( itemLabel );

    // set the icon in data item

    QString icon = d->mIndex.data( Qt::DecorationRole ).toString( );

    d->setIcon( icon );

    // set the description of data item

    QString itemDescription = d->mIndex.data( HbDataFormModelItem::DescriptionRole ).toString();

    d->setDescription( itemDescription );

    //update visualization based on whether item is enabled or disabled

    HbDataFormModel* data_model = static_cast<HbDataFormModel*>(itemView()->model());

    HbDataFormModelItem *model_item = 

        static_cast<HbDataFormModelItem*>(data_model->itemFromIndex(d->mIndex));

    d->setEnabled(model_item->isEnabled());

#ifdef HB_EFFECTS

    //HbEffectInternal::add( HB_DATAFORMVIEWITEM_TYPE,"dataform_expand", "expanded" );

    //HbEffect::start( settingItem, HB_DATAFORMVIEWITEM_TYPE, "expanded" );  

#endif

    // Establish Signal Connections set in HbDataFormModel to th contentWidget of this item

    HbDataFormPrivate::d_ptr(

        static_cast<HbDataForm*>(d->mSharedData->mItemView))->makeConnection(

        d->mIndex.operator const QModelIndex & ());

}

/*!

    \protected constructor

*/

HbDataFormViewItem::HbDataFormViewItem(HbDataFormViewItemPrivate &dd, QGraphicsItem *parent):

    HbAbstractViewItem(dd, parent)

{

    Q_D(HbDataFormViewItem);

    d->q_ptr = this;

    setProperty( "hasIcon", false );

}

/*!

    \protected constructor

*/

HbDataFormViewItem::HbDataFormViewItem(const HbDataFormViewItem &source):

    HbAbstractViewItem( *new HbDataFormViewItemPrivate(*source.d_func()), 0)

{

    Q_D(HbDataFormViewItem);

    d->q_ptr = this;

    setProperty( "hasIcon", false );

}

/*!

    \protected assignment operator

*/

HbDataFormViewItem& HbDataFormViewItem::operator=(const HbDataFormViewItem &source)

{

    Q_D(HbDataFormViewItem);

    *d = *source.d_func();

    setProperty( "hasIcon", false );

    return *this;

}

/*!

    @alpha

    Restores the data from the model and assign to the widget.

    The property for restoring and saving the data need to be initialized when the 

    data item is created.

    \sa save

*/

void HbDataFormViewItem::restore()

{

    Q_D( HbDataFormViewItem );    

    if( d->mType < HbDataFormModelItem::CustomItemBase ) {

        if( d->mContentWidget ) {   

            QVariant newValue;

            QModelIndex itemIndex = modelIndex();

            QString currentProperty;

            // fetch all properties set on this model item

            QHash<QString, QVariant> properties = d->mModelItem->contentWidgetData( );

            QList <QString> propertyNames = properties.keys( );

            int upperBound = 1;

            int lowerBound = 0;

            // get the latest modified property

            QString dirtyProperty = 

                HbDataFormModelItemPrivate::d_ptr( d->mModelItem )->dirtyProperty( );

            // First time when DataItem is created load all property, at runtime load only  the modified

            // property. 

            if(  d->mSetAllProperty ) {

                upperBound = propertyNames.count() ;

                d->mSetAllProperty = false;

            } else {

                // Fetch only the last modified property

                lowerBound = propertyNames.indexOf(dirtyProperty);

                upperBound = lowerBound + 1;

            }

            if( lowerBound > -1 ) {

                for( ;lowerBound < upperBound ;lowerBound++) {

                    newValue = properties.value(propertyNames.at(lowerBound));

                    currentProperty = propertyNames.at(lowerBound);

                    if(newValue.isValid()) {                        

                        if(!d->mContentWidget) {

                            return;

                        }

                        d->mContentWidget->setProperty(currentProperty.toAscii().data(), newValue);

                    }

                }

            }

        }

    }

}

/*!

    @alpha

    Saves the current data of the content widget in data item to the model .

    The property for restoring and saving the data need to be initialized when the 

    data item is created.

    \sa restore

*/

void HbDataFormViewItem::save()

{

    Q_D(HbDataFormViewItem);

    if( d->mType < HbDataFormModelItem::CustomItemBase ) {

        if( d->mContentWidget ) {

            disconnect( d->mModel, SIGNAL( dataChanged( QModelIndex,QModelIndex ) ),

                d->mSharedData->mItemView, SLOT( dataChanged( QModelIndex,QModelIndex ) ) );

            d->mModelItem->setContentWidgetData(

            connect( d->mModel, SIGNAL( dataChanged( QModelIndex,QModelIndex ) ),

                d->mSharedData->mItemView, SLOT( dataChanged( QModelIndex,QModelIndex ) ) );

        }

    }

}

/*!

    @alpha

    This is a virtual function which by default returns NULL. This function must be overridden

    in case user wants to create a data item of type custom item. The user is supposed to pass

    the widget which is wants to display in data item.

*/

HbWidget* HbDataFormViewItem::createCustomWidget()

{

    return 0;

}

/*!

    \reimp 

    Sets the item to either collapse or expanded, depending on the value of \a expanded.

    The function calls setModelIndexes which inturn will make the child items visible/invisible 

    accordingly. This API is valid if HbDataFormViewItem represents a GroupItem.

    \sa isExpanded

*/

void HbDataFormViewItem::setExpanded(bool expanded)

{

    Q_D(HbDataFormViewItem);

    // Expansion is valid only for group ,form page and group page

    if( d->mType < HbDataFormModelItem::SliderItem ) {

        static_cast<HbDataGroup*>(this)->setExpanded(expanded);

    } 

}

/*!

    \reimp

    Returns the expanded state of item.

    \sa setExpanded

*/

bool HbDataFormViewItem::isExpanded() const

{

    Q_D( const HbDataFormViewItem);

    // Expansion is valid only for group ,form page and group page

    if( d->mType < HbDataFormModelItem::SliderItem ) {

        HbDataGroup *group = qobject_cast<HbDataGroup *>(const_cast<HbDataFormViewItem*>(this));

        if( group ) {

            return group->isExpanded();

        } else {

            return false;

        }

    } 

    return false;

}

/*!

    This API is valid only if HbDataFormViewItem represents a data item. Returns the 

    content widget of data item. For example if data item is of type SliderItem then

    this API will return the instance of HbSlider. 

    If user wants to connect to some signals of content widget in data item then this 

    API can be used to fetch the instance of the widget. It will return the instance only

    if data item is visible. User can connect to HbDataForm::activated() signal 

    and when this item is visible then he can query the content widget using this API.

*/

HbWidget* HbDataFormViewItem::dataItemContentWidget()const

{

    Q_D(const HbDataFormViewItem);

    HbWidget *widget = d->mContentWidget;;

    switch( d->mType ) {

        case HbDataFormModelItem::RadioButtonListItem:

            {

                widget = static_cast<HbRadioItem*>(d->mContentWidget)->createRadioButton();

            }

            break;

        case HbDataFormModelItem::MultiselectionItem:

            {

                widget = NULL;

            }

            break;

        case HbDataFormModelItem::ToggleValueItem:

            {

                widget = static_cast<HbToggleItem*>(d->mContentWidget)->contentWidget();

            }

            break;

        default:

            break;

    }

    return widget;

}

/*!

    \reimp

*/

void HbDataFormViewItem::pressStateChanged(bool value, bool animate)

{

    //Since there are no effects defined for mousePressed and mouseReleased for 

    //HbDataFormViewItem we are overriding this function so that redundant effects functions are

    //not called in HbAbstractViewItem::pressStateChanged.

    Q_UNUSED(value);

    Q_UNUSED(animate);

}

void HbDataFormViewItem::initStyleOption(HbStyleOptionDataFormViewItem *option) const

{

    Q_D( const HbDataFormViewItem );

    HbWidget::initStyleOption(option);

    option->label = d->mLabel;

    option->icon = d->mIcon;

    option->description = d->mDescription;

}

void HbDataFormViewItem::showEvent(QShowEvent * event)

{

    Q_D( const HbDataFormViewItem );

    HbWidget::showEvent( event );

    if( d->mIndex.isValid( ) ) {

        emit itemShown( d->mIndex.operator const QModelIndex & ( ) );

    }

}

#include "moc_hbdataformviewitem.cpp"