src/hbcore/gui/hbpopupmanager.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 04 Oct 2010 00:38:12 +0300
changeset 30 80e4d18b72f5
parent 28 b7da29130b0e
permissions -rw-r--r--
Revision: 201037 Kit: 201039

/****************************************************************************
**
** 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 HbCore 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 "hbpopupmanager_p.h"
#include "hbpopupmanager_p_p.h"
#include "hbpopup.h"
#include "hbpopup_p.h"
#include "hbnamespace_p.h"
#include "hbinstance.h"
#include "hbmainwindow_p.h"
#include "hbevent.h"
#include "hbwidget.h"
#include "hbgraphicsscene.h"
#include "hbmenu.h"
#include "hbmenu_p.h"

#include <QGraphicsWidget>
#include <QGraphicsSceneMouseEvent>
#include <QGraphicsLayout>
#include <QEvent>

extern const char* KPositionManagedByVKB;

HbPopupLayoutSpacer::HbPopupLayoutSpacer( QGraphicsItem *parent )
: HbWidgetBase( parent )
{
    setFlag(QGraphicsItem::ItemHasNoContents, true);
    setAcceptedMouseButtons(Qt::NoButton);
}

QSizeF HbPopupLayoutSpacer::sizeHint(Qt::SizeHint which, const QSizeF &constraint ) const
{
    Q_UNUSED( constraint );

    if ( which == Qt::MaximumSize ) {
        return QSizeF( QWIDGETSIZE_MAX, QWIDGETSIZE_MAX );
    }
    return QSizeF(0.f,0.f);
}

HbPopupLayoutProxy::HbPopupLayoutProxy( HbPopup *popup, QGraphicsItem *parent )
: HbWidgetBase(parent), mPopup(popup)
{
    setFlag(QGraphicsItem::ItemHasNoContents, true);
    setAcceptedMouseButtons(Qt::NoButton);
    popup->installEventFilter(this);
}

QSizeF HbPopupLayoutProxy::sizeHint(Qt::SizeHint which, const QSizeF &constraint ) const
{
    if (!mPopup.isNull()) {
        return mPopup->effectiveSizeHint(which, constraint);
    }
    return QSizeF(0, 0);
}

void HbPopupLayoutProxy::setGeometry(const QRectF &rect)
{
     if (!mPopup.isNull()) {
        const QSizeF popupPreferredSize = 
                mPopup->effectiveSizeHint(Qt::PreferredSize);
        const QSizeF usedSize( qMin(rect.width(),   popupPreferredSize.width() ),
                               qMin( rect.height(), popupPreferredSize.height() ) );
        QPointF usedPos(rect.left(), rect.top());
        mPreferredPos = ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->preferredPos;
        mPlacement = ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->placement;
        mPreferredPosSet = ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->preferredPosSet;
        qreal screenMargin = ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->mScreenMargin;
        if ( mPreferredPosSet ) { // user set preferred pos, ignore css
            const qreal pw(parentItem()->boundingRect().width() - screenMargin);
            const qreal ph(parentItem()->boundingRect().height() - screenMargin);
            const qreal uw(usedSize.width());
            const qreal uh(usedSize.height());
            const qreal x(mPreferredPos.x());
            const qreal y(mPreferredPos.y());
            qreal usedx = 0;
            qreal usedy = 0;
            switch( mPlacement  ) {
            case HbPopup::TopLeftCorner:
                usedx = qMin(x, pw-uw);
                usedy = qMin(y, ph-uh);
                break;
            case HbPopup::TopRightCorner:
                usedx = qMin(x-uw, pw-uw);
                usedy = qMin(y, ph-uh);
                break;
            case HbPopup::BottomLeftCorner:
                usedx = qMin(x, pw-uw);
                usedy = qMin(y-uh, ph-uh);
                break;
            case HbPopup::BottomRightCorner:
                usedx = qMin(x-uw, pw-uw);
                usedy = qMin(y-uh, ph-uh);
                break;
            case HbPopup::TopEdgeCenter:
                usedx = qMin(x-uw/2, pw-uw);
                usedy = qMin(y, ph-uh);
                break;
            case HbPopup::RightEdgeCenter:
                usedx = qMin(x-uw, pw-uw);
                usedy = qMin(y-uh/2, ph-uh);
                break;
            case HbPopup::BottomEdgeCenter:
                {
                usedx = qMin(x-uw/2, pw-uw);
                HbMenu *menu = qobject_cast<HbMenu*>(mPopup);
                if(menu && ((y-uh) < 0)) {
                    usedy = qMin(y,ph-uh);
                }
                else {
                    usedy = qMin(y-uh, ph-uh);
                }
                }
                break;
            case HbPopup::LeftEdgeCenter:
                usedx = qMin(x, pw-uw);
                usedy = qMin(y-uh/2, ph-uh);
                break;
            case HbPopup::Center:
                usedx = qMin(x-uw/2, pw-uw);
                usedy = qMin(y-uh/2, ph-uh);
                break;
            default:
                //should not happen
                break;
            }

            if ( usedx < screenMargin ) usedx = screenMargin;
            if ( usedy < screenMargin ) usedy = screenMargin;
            usedPos = QPointF(usedx, usedy);
        }
        if (((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->mAutoLayouting) {
            mPopup->setGeometry(QRectF(usedPos, usedSize));
            ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->mAutoLayouting = true;            
        } else if (mPopup->property(KPositionManagedByVKB).isValid() &&
                   mPopup->property(KPositionManagedByVKB).toBool()) {
            //Special case for the popups which y-position is handled by VKB
            QPointF currentPos = mPopup->pos();
            currentPos.setX(usedPos.x());
            bool previousLayouting = ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->mAutoLayouting;
            ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->mAutoLayouting = true;
            mPopup->setGeometry(QRectF(currentPos, usedSize));
            ((HbPopupPrivate*)HbPopupPrivate::d_ptr(mPopup))->mAutoLayouting = previousLayouting;
        } else {
            mPopup->resize(usedSize);
        }
    }
}

bool HbPopupLayoutProxy::event( QEvent *e ) 
{
    switch ( e->type() )
    {
    case QEvent::Polish:
        polishEvent();
        return QObject::event(e);
    default:
        return HbWidgetBase::event( e );
    }
}

bool HbPopupLayoutProxy::eventFilter(QObject *obj, QEvent *event)
{
    Q_UNUSED( obj );
    switch( event->type() ) {
        case QEvent::LayoutRequest:
        case QEvent::Close:
            {
            updateGeometry();
            break;
            }
        default:
            break;
    }
    return false;
}

HbPopupLayoutManager::HbPopupLayoutManager( HbPopup *popup, QGraphicsScene *scene ) 
: HbWidget()
{        
    setFlag(QGraphicsItem::ItemHasNoContents, true);
    setAcceptedMouseButtons(Qt::NoButton);
    scene->addItem( this );
    //adjust the size of popuplayoutmanager to its preferredSize
    //since it defines the geometries of popups.
    adjustSize();

    // create proxy
    HbPopupLayoutProxy *childItem = new HbPopupLayoutProxy( popup, this );

    // create spacers
    HbStyle::setItemName( new HbPopupLayoutSpacer(this), "spacerTop");
    HbStyle::setItemName( new HbPopupLayoutSpacer(this), "spacerBottom");
    HbStyle::setItemName( new HbPopupLayoutSpacer(this), "spacerLeft");
    HbStyle::setItemName( new HbPopupLayoutSpacer(this), "spacerRight");

    const QMetaObject *metaObject = popup->metaObject();
    if ( metaObject->className() == QLatin1String("HbMenu") ) {
        HbMenu *menu = qobject_cast<HbMenu*>(popup);
        if (menu && menu->menuType() == HbMenu::OptionsMenu) {
            HbStyle::setItemName( childItem, "options-menu" );
        } else {
            HbStyle::setItemName( childItem, "menu" );
        }
    } else if ( metaObject->className() == QLatin1String("HbToolBarExtension" ) ) {
        HbStyle::setItemName( childItem, "toolbar-extension" );
    } else {
        HbStyle::setItemName( childItem, "popup" );        
    }
    setZValue(popup->zValue() - 1);
    if ( metaObject->className() == QLatin1String("HbVolumeSliderPopup") ) {
        HbStyle::setItemName( childItem, "volumesliderpopup" );
        connect(scene,SIGNAL(sceneRectChanged(QRectF)),this,SLOT(orientationChanged(QRectF)));
    }
    if ( metaObject->className() == QLatin1String("HbZoomSliderPopup") ) {
        HbStyle::setItemName( childItem, "zoomsliderpopup" );
        connect(scene,SIGNAL(sceneRectChanged(QRectF)),this,SLOT(orientationChanged(QRectF)));
    }
}

void  HbPopupLayoutManager::orientationChanged(const QRectF& rect)
{
    Q_UNUSED(rect);
    repolish();
}

/*!
    \reimp
*/
QSizeF HbPopupLayoutManager::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const
{
    Q_UNUSED(which);
    Q_UNUSED(constraint);
    return HbDeviceProfile::profile(this).logicalSize();
}

/*
\reimp
*/
void HbPopupLayoutManager::changeEvent(QEvent *event)
{
    HbWidget::changeEvent(event);
    if (event && event->type() == QEvent::LayoutDirectionChange) {
        repolish();
    }

}


/*
    \class HbPopupManagerPrivate
    \brief HbPopupManagerPrivate private data class for HbPopupManager.
*/
HbPopupManagerPrivate::HbPopupManagerPrivate(HbGraphicsScene *scene, QObject * parent):
    QObject(parent),
    topLevelFocusablePopup(0),
    initialFocusedItem(0),
    scene(scene)
{
    connect(&deviceFadeControl, SIGNAL(fadeChange(bool)), this,
        SLOT(deviceFadeChange(bool)));
}

HbPopupManagerPrivate::~HbPopupManagerPrivate()
{
}

/*
    Deliver mouseEvent to all HbPopupBackGround object for non-modal popups until event blocking
    item is found.
*/
void HbPopupManagerPrivate::mouseReleaseEvent(QGraphicsSceneMouseEvent *mouseEvent)
{
    //This function can be removed since popup background is handling the events
    Q_UNUSED(mouseEvent);
    /*foreach (QGraphicsItem *item, scene->items(mouseEvent->scenePos())) {
        if (eventBlockItem(item)) {
            break;
        }
        if (item->type() == HbPrivate::ItemType_PopupBackGround) {
            static_cast<GraphicsItem *>(item)->sceneEvent(mouseEvent);
            // Finish loop if popup of background is modal
            if (static_cast<HbPopupBackGround *>(item)->isModal()) {
                break;
            }
        }
    }*/
}

/*
  Returns true if item is an event blocking item.
*/
bool HbPopupManagerPrivate::eventBlockItem(QGraphicsItem *item)
{
    if (item->type() == HbPrivate::ItemType_FadeItem) {
        return true;
    }

    return false;
}

qreal HbPopupManagerPrivate::popupZValueForPriority( int priority, int popupCountWaterMark )
{
    qreal ret = (qreal)(HbPrivate::PopupZValueDefaultOffset) 
                + (qreal)(priority * HbPrivate::PopupWithDifferentPriorityZValueUnit)
                + (qreal)(popupCountWaterMark * HbPrivate::PopupWithSamePriorityZValueUnit);

    Q_ASSERT (HbPrivate::PopupZValueRangeStart <= ret && ret <= HbPrivate::PopupZValueRangeEnd);

    return ret;
}

qreal HbPopupManagerPrivate::nextPopupZValueForPriority( int priority )
{
    // The priorities are converted to Z values so that the resulting Z value is
    // smaller than HbPrivate::PopupZValue + 1 this ensures that all the popup
    // Z values fit in [HbPrivate::PopupZValue, HbPrivate::PopupZValue + 1] range
    PopupCountRegister popupCountRegister = popupCountRegisters.value(priority, PopupCountRegister());
    popupCountRegister.count++;
    popupCountRegister.waterMark++;
    popupCountRegisters[priority] = popupCountRegister;

    return popupZValueForPriority( priority, popupCountRegister.waterMark );
}

void HbPopupManagerPrivate::updateHash( int priority, qreal zValueOfRemovedPopup )
{
    PopupCountRegister popupCountRegister = popupCountRegisters.value(priority);

    popupCountRegister.count--;
    // If there are no more popups for priority then reset water mark to 0
    if (!popupCountRegister.count) {
        popupCountRegister.waterMark = 0;
    }
    // If the popup that removed had the highest Z value for priority decrease the water mark
    else if (qFuzzyCompare(popupZValueForPriority(priority, popupCountRegister.waterMark), zValueOfRemovedPopup)) {
        popupCountRegister.waterMark--;
    }
    popupCountRegisters[priority] = popupCountRegister;
}

void HbPopupManagerPrivate::eventHook(QEvent *event)
{
    Q_UNUSED(event);
    //This function can be removed since popup background is handling the events
   /* if (event && event->type() == QEvent::GraphicsSceneMouseRelease && popupList.count() && scene) {
        mouseReleaseEvent(static_cast<QGraphicsSceneMouseEvent *>(event));
    }*/
}

void HbPopupManagerPrivate::showPopup(HbPopup *popup)
{
    if (popup) {
        addPopup(popup);
    } else {
        qWarning() << "HbPopupManager::showPopup(): null pointer passed!";
    }
}

void HbPopupManagerPrivate::hidePopup(HbPopup *popup)
{
    if (popup) {
        removePopup(popup);
    }
}

void HbPopupManagerPrivate::addPopup(HbPopup *popup)
{
    if (!popupList.contains(popup)) {
        popupList.append(popup);
        qreal popupZvalue = nextPopupZValueForPriority(HbPopupPrivate::d_ptr(popup)->priority());

        // Set popup and its background item to correct Z value
        popup->setZValue(popupZvalue);
        HbPopupBackGround *backgroundItem = HbPopupPrivate::d_ptr(popup)->backgroundItem;
        if (backgroundItem) {
            backgroundItem->setZValue(popupZvalue - HbPrivate::PopupBackgroundItemZValueUnit);
        }

        if ( !popup->parentItem() ) {
            if ( popup->metaObject()->className() != QLatin1String("HbInputCustomButtonList") &&
                 popup->metaObject()->className() != QLatin1String("HbCharPreviewPane") &&
                 popup->metaObject()->className() != QLatin1String("HbCandidateList") &&
                 popup->metaObject()->className() != QLatin1String("HbExactWordPopup") &&
                 popup->metaObject()->className() != QLatin1String("HbInputSmileyPicker") &&
                 popup->metaObject()->className() != QLatin1String("Hb12KeyCustomKeypad") &&
                 !popup->inherits("HbInputVkbWidget")) {
                setGeometryForPopup( popup );
            }
        }

        // Check if popup is top level popup
        if((!topLevelFocusablePopup || topLevelFocusablePopup->zValue() < popup->zValue()) &&
             popup->flags().testFlag(QGraphicsItem::ItemIsFocusable) ) {

            topLevelFocusablePopup = popup;

            // If this is the first popup in the stack being launched
            if(!initialFocusedItem && scene) {
                initialFocusedItem = scene->focusItem();
            }
            
            // an embedded graphics item is already having a 
            // focus so do not set focus as graphicsscene will automatically
            // set the focus to the embedded item.
            if (!topLevelFocusablePopup->focusItem())
                topLevelFocusablePopup->setFocus();
        }

        updateFading();
    }
}

void HbPopupManagerPrivate::removePopup(HbPopup *popup)
{
    //delete the layoutproxy and remove the popup from parentItems list
    //only if its in its destruction
    bool popupInDestruction = (HbPopupPrivate::d_ptr(popup))->inDestruction;
    if ( parentItems.contains( popup ) && (popupInDestruction)) {
        HbPopupLayoutManager *parentItem = parentItems[popup];
        parentItems.remove( popup );
        delete parentItem;
    }

    // Only execute if close if popup was in popupList before
    if (popupList.removeOne(popup)) {
        // Update popup count registers
        updateHash(HbPopupPrivate::d_ptr(popup)->priority(), popup->zValue());

        // Update fading
        updateFading(true);

        // Find new top level popup
        if (topLevelFocusablePopup && topLevelFocusablePopup == popup) {
            topLevelFocusablePopup = 0;
            foreach (HbPopup *popup, popupList) {
                if ((!topLevelFocusablePopup || topLevelFocusablePopup->zValue() < popup->zValue()) &&
                    popup->flags().testFlag(QGraphicsItem::ItemIsFocusable)){
                    topLevelFocusablePopup = popup;
                }
            }
        }

        bool wasActivePopup = true;
        // If the previous popup was an inactive panel, then it would not have
        // gained focused. So no need to set the focus to the next topmost popup.
        if (popup->isPanel() && !HbPopupPrivate::d_ptr(popup)->mActivePopup) {
            wasActivePopup = false;
        }
        if (topLevelFocusablePopup && wasActivePopup ) {
            topLevelFocusablePopup->setFocus();
            if (HbPopupPrivate::d_ptr(topLevelFocusablePopup)->mActivePopup)
                topLevelFocusablePopup->setActive(true);
        }
        //TODO: this is not very efficient way of deciding if has already been deleted or not
        else if (initialFocusedItem && scene &&
                 scene->items().contains(initialFocusedItem)) {

            // Move the focus to the initial focus item if there is no current focus item or
            // the ancestor of the current fucus item is popup
            if( !scene->focusItem() || scene->focusItem() == popup ||
                popup->isAncestorOf(scene->focusItem())) {
                initialFocusedItem->setFocus();
                initialFocusedItem = 0;
            }
        }
    }
}

void HbPopupManagerPrivate::updateFading(bool unfadeFirst /* false */)
{
    HbPopup *topFadingPopup = 0;
    // Find the top fading popup
    foreach (HbPopup *popup, popupList) {
        if (popup->isBackgroundFaded()) {
            if (!topFadingPopup || topFadingPopup->zValue() < popup->zValue()) {
                topFadingPopup = popup;
            }
        }
    }

    // To avoid double fading, device dialog server may ask applications to
    // set background fading off
    if (deviceFadeControl.fadeOff()) {
        topFadingPopup = 0;
        unfadeFirst = true;
    }
    // Device dialog server commands other applications to set background fading off.
    deviceFadeControl.setFadeOff(topFadingPopup != 0);

    HbMainWindow *mainWindow = 0;
    if (!scene->views().isEmpty()) {
        // in the Hb architecture, there is only one view per scene
        mainWindow = qobject_cast<HbMainWindow *>(scene->views().at(0));
    }
    if (mainWindow) {
        if (unfadeFirst) {
            HbMainWindowPrivate::d_ptr(mainWindow)->unfadeScreen();
        }

        if (topFadingPopup) {
            HbMainWindowPrivate::d_ptr(mainWindow)->fadeScreen(
                    HbPopupPrivate::d_ptr(topFadingPopup)->backgroundItem->zValue() - HbPrivate::FadingItemZValueUnit );
        }
    }
}

// Device wide fading change is requested
void HbPopupManagerPrivate::deviceFadeChange(bool fadeOff)
{
    updateFading(fadeOff);
}

void HbPopupManagerPrivate::setGeometryForPopup(HbPopup *popup)
{
    // clear the old one if deleted
    HbPopupLayoutManager *parentItem = 0;
    HbPopupLayoutProxy *childItem = 0;
    if ( parentItems.contains( popup ) ) {
        parentItem = parentItems[popup];
        childItem = static_cast<HbPopupLayoutProxy*>(parentItem->childItems().at(0));
        if ( childItem->mPopup.isNull() ) {
            parentItems.remove( popup );
            delete parentItem;
        }
    }
    parentItem = 0;
    childItem = 0;
    if ( parentItems.contains( popup ) ) {
        parentItem = parentItems[popup];        
    } else {
        parentItem = new HbPopupLayoutManager( popup, scene );
        parentItems.insert( popup, parentItem );
    }    

    childItem = static_cast<HbPopupLayoutProxy*>(parentItem->childItems().at(0));
    childItem->setSizePolicy( popup->sizePolicy() );
}


/*
    \class HbPopupManager
    \brief HbPopupManager is managing the priority order of HbPopup objects and fading of
           the screen.
*/

HbPopupManager::HbPopupManager(HbGraphicsScene *scene, QObject *parent): QObject(parent)
{
    d = new HbPopupManagerPrivate(scene, this);
}

/*
    Destructor.
*/
HbPopupManager::~HbPopupManager()
{
// no need to delete d because it is child of this object
}

void HbPopupManager::eventHook(QEvent *event)
{
    //This function can be removed
    Q_UNUSED(event);
    //d->eventHook(event);
}

void HbPopupManager::showPopup(HbPopup *popup)
{
    d->showPopup(popup);
}

void HbPopupManager::hidePopup(HbPopup *popup)
{
    d->hidePopup(popup);
}