#include <hblabel.h>

      mDateObserver(0),

      mNoMailsLabel(0)

 Destructor

 */

 \fn QPainterPath NmHsWidget::shape()

 Called by home screen fw to check widget boundaries, needed to draw

 outside widget boundingRect.

 /return QPainterPath path describing actual boundaries of widget 

  including child items

 */

QPainterPath NmHsWidget::shape() const

{

    NM_FUNCTION;

    QPainterPath path;

    path.setFillRule(Qt::WindingFill);

    path.addRect(this->rect());

    if (mTitleRow){

        path.addPath(mTitleRow->shape());

    }

    return path.simplified();

}

/*!

 \fn void NmHsWidget::onShow()

 called by home screen fw when widget gets visible

 */

    if (mEngine) {

    }

 \fn void NmHsWidget::onHide()

 called by home screen fw when widget gets hidden

 */

void NmHsWidget::onHide()

    if (mEngine) {

        mEngine->suspend();

    }

 Initializes Localization.

 /post mTranslator constructed & localization file loaded

 */

void NmHsWidget::setupLocalization()

{

    NM_FUNCTION;

    //Use correct localisation

    mTranslator = new QTranslator();

    QString lang = QLocale::system().name();

    mTranslator->load(KNmHsWidgetLocFileName + lang, KNmHsWidgetLocLocation);

    QCoreApplication::installTranslator(mTranslator);

}

/*!

 Initializes UI. Everything that is not done in docml files should be here.

 return true if ok, in error false.

 */

    setContentsMargins(KNmHsWidgetContentsMargin, KNmHsWidgetContentsMargin,

        KNmHsWidgetContentsMargin, KNmHsWidgetContentsMargin);

        KNmHsWidgetContentsMargin, KNmHsWidgetContentsMargin);

    //background

    mBackgroundFrameDrawer = new HbFrameDrawer(KNmHsWidgetBackgroundImage,

        HbFrameDrawer::NinePieces);

    HbFrameItem* backgroundLayoutItem = new HbFrameItem(mBackgroundFrameDrawer);

    //set to NULL to indicate that ownership transferred

    mBackgroundFrameDrawer = NULL;

    setBackgroundItem(backgroundLayoutItem);

    //Create NoMails Label.

    mNoMailsLabel = new HbLabel(this);

    mNoMailsLabel->setPlainText(hbTrId("txt_mail_widget_info_no_messages"));

    HbFontSpec fontSpec(HbFontSpec::Secondary);

    HbStyle style;

    qreal size;

    bool found = style.parameter(QString("hb-param-text-height-tiny"), size);

    if (found) {

        fontSpec.setTextHeight(size);

    }

    mNoMailsLabel->setFontSpec(fontSpec);

    QColor newFontColor;

    newFontColor = HbColorScheme::color("qtc_hs_list_item_content_normal");

    mNoMailsLabel->setTextColor(newFontColor);

    mNoMailsLabel->setAlignment(Qt::AlignCenter);

    mNoMailsLabel->setVisible(false);

 Initializes the widget.

 called by home screen fw when widget is added to home screen

 */

    QT_TRY {

        setupLocalization();

        //Engine construction is 2 phased. 

        mEngine = new NmHsWidgetEmailEngine(mAccountId);

        //Client must connect to exception signals before calling the initialize function

        //because we don't want to miss any signals.

        connect(mEngine, SIGNAL( exceptionOccured(const int&) ), this,

            SLOT( onEngineException(const int&) ));

        if (!mEngine->initialize()) {

            //engine construction failed. Give up.

        mTitleRow = new NmHsWidgetTitleRow(this);

        if (!mTitleRow->setupUI()) {

        //create observer for date/time change events

        mDateObserver = new NmHsWidgetDateTimeObserver();

        //Crete MailRows and associated connections

        createMailRowsList();

        connect(mEngine, SIGNAL( mailDataChanged() ), this, SLOT( updateMailData() ));

    QT_CATCH(...) {

 updateMailData slot

 */

    }

    updateLayout(count);

    //count is safe for envelopes and mMailRows

    for (int i = 0; i < count; i++) {

        mMailRows.at(i)->updateMailData(envelopes.at(i));

    }

 Sets monitored account id from given string

 Needed for home screen framework which supports only QString type properties

 */

    if (!ok) {

        NM_ERROR(1, "NmHsWidget::setAccountId: invalid account ID data, signal finished()!!!");

        return;

    }

    mAccountId.setId(id);

 Returns monitored account id as a string

 Needed for home screen framework which supports only QString type properties

 */

 Sets monitored account icon name from given string

 */

 Returns monitored account icon name

 */

 Slot to handle expand/collapse trigger event

 */

 Sets widget expand/collapse state

 /post widget expansion state is changed

 */

 Sets expand/collapse state from given string (needed by homescreen)

 */

    if (value == KNmHsWidgetStateCollapsed) {

    }

    else {

        mIsExpanded = true;

    }

}

/*!

 Returns widget expand/collapse state as string (needed by homescreen) 

 */

QString NmHsWidget::widgetStateProperty()

{

    NM_FUNCTION;

    if (mIsExpanded) {

        return KNmHsWidgetStateExpanded;

    }

    else {

        return KNmHsWidgetStateCollapsed;

    }

}

/*!

 Updates mMailRows list to include KMaxNumberOfMailsShown mail row widgets

 /post mMailRows contains KMaxNumberOfMailsShown mailRows 

 */

void NmHsWidget::createMailRowsList()

{

    NM_FUNCTION;

    //make sure that there are as many email rows as needed

    while (mMailRows.count() < KMaxNumberOfMailsShown) {

        NmHsWidgetEmailRow *row = new NmHsWidgetEmailRow(this);

        if (!row->setupUI()) {

            NM_ERROR(1, "NmHsWidget::createMailRowsList row->setUpUI() fails");

            //if setupUI fails no point to proceed

            emit error();

            return;

        connect(row, SIGNAL(mailViewerLaunchTriggered(const NmId&)), mEngine,

            SLOT(launchMailAppMailViewer(const NmId&)));

        connect(mDateObserver, SIGNAL(dateTimeChanged()), row, SLOT(updateDateTime()));

        mMailRows.append(row);

    }

 Updates the Layout to contain the right items

 /param mailCount defines how many emails is to be shown

 /post If widget is collapsed, the layout contains only titleRow widget.

 If widget is expanded and mailCount is 0 layout will contain

 titlerow & noMailsLabel. 

 If widget is expanded and mailCount is greter

 than zero, layout will contain titlerow and KMaxNumberOfMailsShown times

 emailrow(s)

 */

void NmHsWidget::updateLayout(const int mailCount)

    if (mIsExpanded) {

        if (mailCount == 0) {

            addNoMailsLabelToLayout();

            removeEmailRowsFromLayout();

        }

        else {

            removeNoMailsLabelFromLayout();

            addEmailRowsToLayout();

    }

    else {

        removeNoMailsLabelFromLayout();

        removeEmailRowsFromLayout();

    }

    //resize the widget to new layout size

    setPreferredSize(mRowLayout->preferredSize());

    updateMailRowsVisibility(mailCount);

}

/*!

 Updates mNoMailsLabel visibility based on widget state

 /param mailCount defines how many mail rows is needed

 /post if mail count is 0 and mIsExpanded equals true, then

 the mNoMailLabel is added to the mRowLayout. 

 */

void NmHsWidget::addNoMailsLabelToLayout()

{

    NM_FUNCTION;

    //Use sizes defined for titlerow and mailrow docml to indentify the correct size

    //for the mNoMailslabel

    if (mNoMailsLabel->isVisible() || mMailRows.isEmpty()) {

        return;

    }

    QSizeF mailLabelSize(mTitleRow->maximumWidth(), KMaxNumberOfMailsShown

        * mMailRows.first()->maximumHeight());

    mNoMailsLabel->setPreferredSize(mailLabelSize);

    mNoMailsLabel->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);

    //Add mNoMailsLabel to layout if not yet there and show it

    mRowLayout->addItem(mNoMailsLabel);

    //resize the widget to new layout size

    mNoMailsLabel->show();

}

/*!

 removeNoMailsLabelFromLayout removes mNoMailsLabel from the layout

 /post mNoMailsLabel is not in mRowLayout

 */

void NmHsWidget::removeNoMailsLabelFromLayout()

{

    NM_FUNCTION;

    //remove mNoMailsLabel from Layout and hide it

    mRowLayout->removeItem(mNoMailsLabel);

    mNoMailsLabel->hide();

}

/*!

 addEmailRowsToLayout adds every emailrow to the layout

 /post all elements in mMailRows are added to mRowLayout

 */

void NmHsWidget::addEmailRowsToLayout()

{

    NM_FUNCTION;

    foreach(NmHsWidgetEmailRow *row, mMailRows)

            mRowLayout->addItem(row);

 removeEmailRowsFromLayout removes every emailrow from the layout

 /post none of the elements in mMailRows are in mRowLayout

 */

void NmHsWidget::removeEmailRowsFromLayout()