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

**

** 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 <QPalette>

#include <QPainter>

#include <QStyle>

#include <QDebug>

#include <QTextDocument>

#include <QGraphicsSceneResizeEvent>

#include "hbiconitem.h"

#include "hbinstance.h"

#include "hbcolorscheme.h"

#include "hbwidget_p.h"

#include "hbstyleoptionlabel_p.h"

#include "hbwidgetbase.h"

#include "hblabel.h"

#include "hbstyle_p.h"

/*!

    @alpha

    @hbcore

    \class HbLabel

    \brief HbLabel is a label widget for showing a text or an icon.

    HbLabel supports the following content types

    \li plain text

    \li html (rich text)

    \li icon

    A label can show only one type of content at a time.

    The following is an example of how to create an icon and add it to a label using the HbLabel API.

    As the label is not managed by a layout, it must be positioned and sized.

    \snippet{ultimatecodesnippet/ultimatecodesnippet.cpp,5}

    An example how to add labels into a layout. Explicit positioning and

    sizing of the HbLabel objects are not needed.

    \snippet{ultimatecodesnippet/ultimatecodesnippet.cpp,6}

    The following is an example how to set the color of plain text label. This is a special case

    because of colors are usually set by layout system and there is no need to set colors explicitly.

    \snippet{ultimatecodesnippet/ultimatecodesnippet.cpp,7}

    \sa HbIcon

 */

/*!

    \var HbLabel::PlainText

    Text in plain text format.

 */

/*!

    \var HbLabel::RichText

    Text in rich text format.

 */

/*!

    \var HbLabel::Icon

    Icon.

 */

class HbLabelPrivate: public HbWidgetPrivate {

    Q_DECLARE_PUBLIC(HbLabel)

public:

    void clearAll();

    void setIcon(const HbIcon &icon);

    void updatePrimitives ();

    void createPrimitives ();

    //shared between icon and text

    // text section

    // icon section

    // primitive handling

};

HbLabelPrivate::HbLabelPrivate() :

        HbWidgetPrivate(),

        mPrimitiveItem(0),

{

}

void HbLabelPrivate::clearAll()

{

    if (mPrimitiveItem) {

        delete mPrimitiveItem;

        mPrimitiveItem = 0;

    }

    mText.clear();

    mIcon.clear();

}

{

    Q_Q(HbLabel);

    if (text.isNull()) {

        clearAll();

        return;

    }

    if (mActivePrimitive != primitiveId) {

        clearAll();

    }

        mText = text;

        if (mActivePrimitive != primitiveId) {

            mActivePrimitive = primitiveId;

            createPrimitives();

            q->repolish(); // reconecting new primitive to HbAnchorLayout so it is really needed!

        }

        q->updatePrimitives();

    }

}

void HbLabelPrivate::setIcon(const HbIcon &icon)

{

    Q_Q(HbLabel);

    if (icon.isNull()) {

        clearAll();

        return;

    }

        clearAll();

    }

    if (mIcon != icon) {

        mIcon = icon;

            createPrimitives();

            q->repolish(); // reconecting new primitive to HbAnchorLayout so it is really needed!

        }

        q->updatePrimitives();

    }

}

HbLabelPrivate::~HbLabelPrivate()

{

}

void HbLabelPrivate::createPrimitives()

{

    Q_Q(HbLabel);

    Q_ASSERT(mPrimitiveItem==0);

    }

}

void HbLabelPrivate::updatePrimitives()

{

    Q_Q(HbLabel);

    }

}

/*!

    Constructs the label with a given \a parent.

    \param parent - the parent graphics item.

 */

HbLabel::HbLabel(QGraphicsItem *parent) :

        HbWidget(*new HbLabelPrivate, parent)

{

    setFlag(QGraphicsItem::ItemClipsChildrenToShape, true);

}

/*!

    \internal

 */

HbLabel::HbLabel(HbLabelPrivate &dd, QGraphicsItem * parent) :

        HbWidget(dd, parent)

{

    setFlag(QGraphicsItem::ItemClipsChildrenToShape, true);

}

/*!

    Constructs the label with a given \a text and \a parent. This constructor is a convenience for

    common use case to have a label with plain text content. Using this contructor you do not need

    to call setPlainText() separately in initialization.

    \param displayText - the plain text that is shown in the label.

    \param parent - the parent graphics item.

 */

HbLabel::HbLabel(const QString &displayText, QGraphicsItem *parent) :

        HbWidget(*new HbLabelPrivate, parent)

{

    setFlag(QGraphicsItem::ItemClipsChildrenToShape, true);

    setPlainText(displayText);

}

/*!

    Label destructor.

 */

HbLabel::~HbLabel ()

{

}

/*!

    Sets the label contents to plain text containing the textual

    representation of integer \a num. Any previous content is cleared.

    Does nothing if the integer's string representation is the same as

    the current contents of the label.

    \param num - the number that is shown in the label.

    \sa setPlainText()

 */

void HbLabel::setNumber(int number)

{

    QString str;

    str.setNum(number);

    setPlainText(str);

}

/*!

    \overload

    Sets the label contents to plain text containing the textual

    representation of double \a num. Any previous content is cleared.

    Does nothing if the double's string representation is the same as

    the current contents of the label.

    \param num - the number that is shown in the label.

    \sa setPlainText()

 */

void HbLabel::setNumber(qreal number)

{

    QString str;

    str.setNum(number);

    setPlainText(str);

}

/*!

    Sets the text elide mode to \a elideMode.

    The elide mode specifies where text tructation and ellipsis "..." are applied if the label text

    is too large to fit the label's dimensions.

    \param elideMode - the new elide mode.

    \sa elideMode

    \sa Qt::TextElideMode

 */

void HbLabel::setElideMode (Qt::TextElideMode elideMode)

{

    Q_D(HbLabel);

    if (elideMode != d->mElideMode) {

        d->mElideMode = elideMode;

            updatePrimitives();

        }

    }

}

/*!

    Default elide mode is Qt::ElideRight.

    \return the elide mode of the text.

    \sa HbLabel::setElideMode()

 */

Qt::TextElideMode HbLabel::elideMode() const

{

    Q_D(const HbLabel);

}

/*!

    Sets the text wrapping mode to \a mode.

    \param mode - wrapping mode

    \sa Hb::TextWrapping

 */

void HbLabel::setTextWrapping(Hb::TextWrapping mode)

{

    Q_D(HbLabel);

    if (d->mTextWrapping != mode) {

        d->mTextWrapping = mode;

            updatePrimitives();

        }

    }

}

/*!

    \return the label's current text wrapping mode.

    \sa setTextWrapping()

 */

Hb::TextWrapping HbLabel::textWrapping() const

{

    Q_D(const HbLabel);

}

/*!

    Sets the icon displayed by this label.

    Removes any existing text from the label.

    \param icon - the icon that this label displays.

    \sa icon

 */

void HbLabel::setIcon(const HbIcon &icon)

{

    Q_D(HbLabel);

    d->setIcon(icon);

}

/*!

    \return the icon displayed by this label.

    \sa setIcon

 */

HbIcon HbLabel::icon() const

{

    Q_D(const HbLabel);

}

/*!

    Clears the content of the label. After this the label is empty.

    \sa isEmpty()

 */

void HbLabel::clear()

{

    Q_D(HbLabel);

    d->clearAll();

}

/*!

    Sets the aspect ratio mode for the icon. The default aspect ratio is Qt::KeepAspectRatio.

    \param aspectRatioMode - the new aspect ration mode.

    \sa aspectRatioMode()

 */

void HbLabel::setAspectRatioMode(Qt::AspectRatioMode aspectRatioMode)

{

    Q_D(HbLabel);

    if (d->mAspectRatioMode != aspectRatioMode) {

        d->mAspectRatioMode = aspectRatioMode;

            updatePrimitives();

        }

    }

}

/*!

    \return the aspect ratio set for the icon. The default aspect ratio is

    Qt::KeepAspectRatio.

    \sa setAspectRatio()

 */

Qt::AspectRatioMode HbLabel::aspectRatioMode() const

{

    Q_D(const HbLabel);

}

/*!

    Sets the label contents to plain text containing \a text. Any previous content is cleared.

    Does nothing if the string representation is the same as the current contents of the label.

    \param text - the plain text that is shown in the label.