/****************************************************************************+
−
**+
−
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).+
−
** All rights reserved.+
−
** Contact: Nokia Corporation (qt-info@nokia.com)+
−
**+
−
** This file is part of the QtGui module of the Qt Toolkit.+
−
**+
−
** $QT_BEGIN_LICENSE:LGPL$+
−
** No Commercial Usage+
−
** This file contains pre-release code and may not be distributed.+
−
** You may use this file in accordance with the terms and conditions+
−
** contained in the Technology Preview License Agreement accompanying+
−
** this package.+
−
**+
−
** GNU Lesser General Public License Usage+
−
** Alternatively, 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 qt-info@nokia.com.+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
** $QT_END_LICENSE$+
−
**+
−
****************************************************************************/+
−
+
−
#include "qapplication.h"+
−
#include "qevent.h"+
−
#include "qbitmap.h"+
−
#include "private/qsoftkeymanager_p.h"+
−
#include "private/qobject_p.h"+
−
#include "private/qsoftkeymanager_common_p.h"+
−
+
−
#ifdef Q_WS_S60+
−
#include "private/qsoftkeymanager_s60_p.h"+
−
#endif+
−
+
−
#ifndef QT_NO_SOFTKEYMANAGER+
−
QT_BEGIN_NAMESPACE+
−
+
−
QSoftKeyManager *QSoftKeyManagerPrivate::self = 0;+
−
+
−
const char *QSoftKeyManager::standardSoftKeyText(StandardSoftKey standardKey)+
−
{+
−
    const char *softKeyText = 0;+
−
    switch (standardKey) {+
−
    case OkSoftKey:+
−
        softKeyText = QT_TRANSLATE_NOOP("QSoftKeyManager", "Ok");+
−
        break;+
−
    case SelectSoftKey:+
−
        softKeyText = QT_TRANSLATE_NOOP("QSoftKeyManager", "Select");+
−
        break;+
−
    case DoneSoftKey:+
−
        softKeyText = QT_TRANSLATE_NOOP("QSoftKeyManager", "Done");+
−
        break;+
−
    case MenuSoftKey:+
−
        softKeyText = QT_TRANSLATE_NOOP("QSoftKeyManager", "Options");+
−
        break;+
−
    case CancelSoftKey:+
−
        softKeyText = QT_TRANSLATE_NOOP("QSoftKeyManager", "Cancel");+
−
        break;+
−
    default:+
−
        break;+
−
    };+
−
+
−
    return softKeyText;+
−
}+
−
+
−
QSoftKeyManager *QSoftKeyManager::instance()+
−
{+
−
    if (!QSoftKeyManagerPrivate::self)+
−
        QSoftKeyManagerPrivate::self = new QSoftKeyManager;+
−
+
−
    return QSoftKeyManagerPrivate::self;+
−
}+
−
+
−
QSoftKeyManager::QSoftKeyManager() :+
−
#ifdef Q_WS_S60+
−
    QObject(*(new QSoftKeyManagerPrivateS60), 0)+
−
#else+
−
    QObject(*(new QSoftKeyManagerPrivate), 0)+
−
#endif+
−
{+
−
}+
−
+
−
QAction *QSoftKeyManager::createAction(StandardSoftKey standardKey, QWidget *actionWidget)+
−
{+
−
    const char* text = standardSoftKeyText(standardKey);+
−
    QAction *action = new QAction(QSoftKeyManager::tr(text), actionWidget);+
−
    QAction::SoftKeyRole softKeyRole = QAction::NoSoftKey;+
−
    switch (standardKey) {+
−
    case MenuSoftKey: // FALL-THROUGH+
−
        action->setProperty(MENU_ACTION_PROPERTY, QVariant(true)); // TODO: can be refactored away to use _q_action_menubar+
−
    case OkSoftKey:+
−
    case SelectSoftKey:+
−
    case DoneSoftKey:+
−
        softKeyRole = QAction::PositiveSoftKey;+
−
        break;+
−
    case CancelSoftKey:+
−
        softKeyRole = QAction::NegativeSoftKey;+
−
        break;+
−
    }+
−
    action->setSoftKeyRole(softKeyRole);+
−
    return action;+
−
}+
−
+
−
/*! \internal+
−
+
−
  Creates a QAction and registers the 'triggered' signal to send the given key event to+
−
  \a actionWidget as a convenience.+
−
+
−
*/+
−
QAction *QSoftKeyManager::createKeyedAction(StandardSoftKey standardKey, Qt::Key key, QWidget *actionWidget)+
−
{+
−
#ifndef QT_NO_ACTION+
−
    QScopedPointer<QAction> action(createAction(standardKey, actionWidget));+
−
+
−
    connect(action.data(), SIGNAL(triggered()), QSoftKeyManager::instance(), SLOT(sendKeyEvent()));+
−
    connect(action.data(), SIGNAL(destroyed(QObject*)), QSoftKeyManager::instance(), SLOT(cleanupHash(QObject*)));+
−
    QSoftKeyManager::instance()->d_func()->keyedActions.insert(action.data(), key);+
−
    return action.take();+
−
#endif //QT_NO_ACTION+
−
}+
−
+
−
void QSoftKeyManager::cleanupHash(QObject *obj)+
−
{+
−
    Q_D(QSoftKeyManager);+
−
    QAction *action = qobject_cast<QAction*>(obj);+
−
    d->keyedActions.remove(action);+
−
}+
−
+
−
void QSoftKeyManager::sendKeyEvent()+
−
{+
−
    Q_D(QSoftKeyManager);+
−
    QAction *action = qobject_cast<QAction*>(sender());+
−
+
−
    if (!action)+
−
        return;+
−
+
−
    Qt::Key keyToSend = d->keyedActions.value(action, Qt::Key_unknown);+
−
+
−
    if (keyToSend != Qt::Key_unknown)+
−
        QApplication::postEvent(action->parentWidget(),+
−
                                new QKeyEvent(QEvent::KeyPress, keyToSend, Qt::NoModifier));+
−
}+
−
+
−
void QSoftKeyManager::updateSoftKeys()+
−
{+
−
    QEvent *event = new QEvent(QEvent::UpdateSoftKeys);+
−
    QApplication::postEvent(QSoftKeyManager::instance(), event);+
−
}+
−
+
−
bool QSoftKeyManager::appendSoftkeys(const QWidget &source, int level)+
−
{+
−
    Q_D(QSoftKeyManager);+
−
    bool ret = false;+
−
    QList<QAction*> actions = source.actions();+
−
    for (int i = 0; i < actions.count(); ++i) {+
−
        if (actions.at(i)->softKeyRole() != QAction::NoSoftKey) {+
−
            d->requestedSoftKeyActions.insert(level, actions.at(i));+
−
            ret = true;+
−
        }+
−
    }+
−
    return ret;+
−
}+
−
+
−
QWidget *QSoftKeyManager::softkeySource(QWidget *previousSource, bool& recursiveMerging)+
−
{+
−
    Q_D(QSoftKeyManager);+
−
    QWidget *source = NULL;+
−
    if (!previousSource) {+
−
        // Initial source is primarily focuswidget and secondarily activeWindow+
−
        source = QApplication::focusWidget();+
−
        if (!source)+
−
            source = QApplication::activeWindow();+
−
    } else {+
−
        // Softkey merging is based on four criterias+
−
        // 1. Implicit merging is used whenever focus widget does not specify any softkeys+
−
        bool implicitMerging = d->requestedSoftKeyActions.isEmpty();+
−
        // 2. Explicit merging with parent is used whenever WA_MergeSoftkeys widget attribute is set+
−
        bool explicitMerging = previousSource->testAttribute(Qt::WA_MergeSoftkeys);+
−
        // 3. Explicit merging with all parents+
−
        recursiveMerging |= previousSource->testAttribute(Qt::WA_MergeSoftkeysRecursively);+
−
        // 4. Implicit and explicit merging always stops at window boundary+
−
        bool merging = (implicitMerging || explicitMerging || recursiveMerging) && !previousSource->isWindow();+
−
+
−
        source = merging ? previousSource->parentWidget() : NULL;+
−
    }+
−
    return source;+
−
}+
−
+
−
bool QSoftKeyManager::handleUpdateSoftKeys()+
−
{+
−
    Q_D(QSoftKeyManager);+
−
    int level = 0;+
−
    d->requestedSoftKeyActions.clear();+
−
    bool recursiveMerging = false;+
−
    QWidget *source = softkeySource(NULL, recursiveMerging);+
−
    do {+
−
        if (source) {+
−
            bool added = appendSoftkeys(*source, level);+
−
            source = softkeySource(source, recursiveMerging);+
−
            level = added ? ++level : level;+
−
        }+
−
    } while (source);+
−
+
−
    d->updateSoftKeys_sys();+
−
    return true;+
−
}+
−
+
−
bool QSoftKeyManager::event(QEvent *e)+
−
{+
−
#ifndef QT_NO_ACTION+
−
    if (e->type() == QEvent::UpdateSoftKeys)+
−
        return handleUpdateSoftKeys();+
−
#endif //QT_NO_ACTION+
−
    return false;+
−
}+
−
+
−
#ifdef Q_WS_S60+
−
bool QSoftKeyManager::handleCommand(int command)+
−
{+
−
    return static_cast<QSoftKeyManagerPrivateS60*>(QSoftKeyManager::instance()->d_func())->handleCommand(command);+
−
}+
−
#endif+
−
+
−
QT_END_NAMESPACE+
−
#endif //QT_NO_SOFTKEYMANAGER+
−