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

**

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

#include <QGraphicsView>

#include <QGraphicsProxyWidget>

#include <QLocale>

#include "hbinputmethod.h"

#include "hbinputmethod_p.h"

#include "hbinputmodecache_p.h"

#include "hbinputsettingproxy.h"

#include "hbinputcontextproxy_p.h"

#include "hbinputfilter.h"

#include "hbinputmethodnull_p.h"

#include "hbinputpredictionfactory.h"

#include "hbinputstandardfilters.h"

#include "hbinpututils.h"

#include "hbinputvkbhost.h"

/*!

@alpha

@hbcore

\class HbInputMethod

\brief A base class for input method implementations.

HbInputMethod is the base class for input method implementations. It inherits from QInputContext,

support newly focused editor.

Custom input methods are a special class of input methods. Once a custom input method is

Following is the basic input framework program flow:

1. An editor gains input focus.

2  Input mode cache resolves correct mode handler and activates it.

3. A virtual function HbInputMethod::focusReceived is called. At this point the input method

   initializes whatever it needs to initialize in order to start the input operation (for example,

   opens the virtual keyboard by using HbVkbHost API) and waits for user actions.

4. Text is written. The input method delivers results to the editor buffer by using HbInputFocusObject API.

   It can access editor attributes via HbEditorInterface API.

   HbInputMethod::focusLost and is expected to conclude any ongoing input operations and shut down active

6. The input method waits for next focusReceived() call.

\sa QInputContext

\sa HbInputFocusObject

\sa HbEditorInterface

\sa HbVkbHost

*/

/*!

Constructs the object

*/

HbInputMethod::HbInputMethod() : d_ptr(new HbInputMethodPrivate(this))

{

}

/*!

Destructs the object

*/

HbInputMethod::~HbInputMethod()

{

    HbInputSettingProxy::instance()->disconnectObservingObject(this);

    delete d_ptr;

}

/*!

*/

bool HbInputMethod::initializeFramework(QApplication& app)

{

    // Activate singleton shutdown.

    connect(&app, SIGNAL(aboutToQuit()), HbInputModeCache::instance(), SLOT(shutdown()));

    connect(&app, SIGNAL(aboutToQuit()), HbInputSettingProxy::instance(), SLOT(shutdown()));

    connect(&app, SIGNAL(aboutToQuit()), HbPredictionFactory::instance(), SLOT(shutDown()));

    HbInputMethod *master = HbInputMethodNull::Instance();

    if (!master) {

        return false;

    }

    master->d_ptr->mIsActive = true;

    // Finally set application input context.

    QInputContext* proxy = master->d_ptr->newProxy();

    app.setInputContext(proxy);

    return true;

}

/*!

InitializeFramework method has been called, even when there is no focused editor (in some cases it may

*/

HbInputMethod* HbInputMethod::activeInputMethod()

{

    // First try, try app input context directly. It is possible that it is an instance

    // of HbInputMethod that is installed directly there without framework knowing about it

    // (that shouldn't be done, but it is possible). That's why we rely on app input context as

    // a primary source instead of mode cache.

    QInputContext* context = qApp->inputContext();

    if (context && context->inherits("HbInputMethod")) {

        HbInputMethod* active = static_cast<HbInputMethod*>(context);

        return active;

    }

    // Then check if the 'null' is active.

    HbInputMethod* nullInstance = HbInputMethodNull::Instance();

    if (nullInstance && nullInstance->isActiveMethod()) {

        return nullInstance;

    }

    // No it wasn't, then go through the methods in the cache and see which one is

    // active.

    return HbInputModeCache::instance()->activeMethod();

}

/*!

Lists custom input methods.

*/

QList<HbInputMethodDescriptor> HbInputMethod::listCustomInputMethods()

{

    return HbInputModeCache::instance()->listCustomInputMethods();

}

/*!

switched to custom method. Returns false if input method was not found

or the framework was not able to activate it.

*/

bool HbInputMethod::activateInputMethod(const HbInputMethodDescriptor &inputMethod)

{

    Q_D(HbInputMethod);

    if (!inputMethod.isEmpty()) {

        HbInputSettingProxy::instance()->setActiveCustomInputMethod(inputMethod);

        if (inputMethod.isDefault()) {

           d->setFocusCommon();

           return true;

        } else {

            HbInputMethod *customMethod = HbInputModeCache::instance()->loadInputMethod(inputMethod);

            if (customMethod) {

                d->contextSwitch(customMethod);

               return true;

           }

        }

    }

    return false;

}

/*!

This slot is called when the input language changes. The framework connects it

to the input setting proxy. When the signal is received, the input method implementation

is notified by calling inputLanguageChanged.

\sa inputLanguageChanged

\sa HbInputSettingProxy

*/

void HbInputMethod::globalInputLanguageChanged(const HbInputLanguage &newLanguage)

    Q_D(HbInputMethod);

    inputLanguageChanged(newLanguage);

    if (!isActiveMethod()) {

        // Notify non-active input methods of language change, but check

        // if the method has promised to handle the new language only

        // in the active method

        return;

    }

    // Just behave as if this was the first focus operation

    // to this editor.

        HbInputState state;

        activateState(state);

    }

}

/*!

This slot is called when the secondary input language changes. The framework connects it

to the input setting proxy. When the signal is received, the input method implementation

is notified by calling secondaryInputLanguageChanged.

\sa secondaryInputLanguageChanged

\sa HbInputSettingProxy

*/

{

}

/*!

*/

void HbInputMethod::activeHwKeyboardChanged(HbKeyboardType newKeyboard)

{

    Q_UNUSED(newKeyboard);

    Q_D(HbInputMethod);

    // Do here whatever needs to be done on HbInputMethod level, then

    // call virtual ActiveKeyboardChanged() in case plugin needs to do something.

    // ...

    d->refreshState();

}

/*!

*/

void HbInputMethod::activeTouchKeyboardChanged(HbKeyboardType newKeyboard)

{

    Q_UNUSED(newKeyboard);

    Q_D(HbInputMethod);

    d->refreshState();

}

/*!

This slot is connected to the setting proxy activeKeyboard attribute. It will

activate proper state when the signal is received.

*/

void HbInputMethod::activeKeyboardChanged(HbKeyboardType newKeyboard)

{

    if (!isActiveMethod()) {

        return;

    }

    Q_D(HbInputMethod);

    d->mInputState.setKeyboard(newKeyboard);

    if (stateHandler) {

        d->inputStateToEditor(d->mInputState);

        if (stateHandler != this) {

            // Context switch needed.

            d->contextSwitch(stateHandler);

        } else {

            // Same method handles new state, just report the state change.

            inputStateActivated(d->mInputState);

        }

    }

}

/*!

*/

void HbInputMethod::predictiveInputStateChanged(int newStatus)

{

}

/*!

The framework calls this method when an input capable widget receives UI focus. This is empty

default implementation and the inheriting class should override it.

\sa focusLost

*/

void HbInputMethod::focusReceived()

{

    // Empty default implementation, do nothing.

}

/*!

The framework calls this method when an active editor loses focus. The parameter focusSwitch

is true if the focus is moving from one editor to another and false if the input focus

going to be lost completely.

\sa focusReceived

*/

void HbInputMethod::focusLost(bool focusSwitch)

{

    Q_UNUSED(focusSwitch);

    // Empty default implementation, do nothing.

}

/*!

Returns pointer to active focus object.

*/

HbInputFocusObject* HbInputMethod::focusObject() const

{

    Q_D(const HbInputMethod);

    return d->mFocusObject;

}

/*!

QWidget based editors notify focus changes through this method. This is the

default focus handling mechanism for QInputContext system. Input method

implementation should never override this method unless it knows what it is doing.

\sa setFocusObject

*/

void HbInputMethod::setFocusWidget(QWidget* widget)

{

    Q_D(HbInputMethod);

    if (d->mFocusLocked) {

        return;

    }

    QInputContext::setFocusWidget(widget);

    if (!widget) {

        // Losing focus.

            focusLost(false);

            delete d->mFocusObject;

            d->mFocusObject = 0;

        }

        return;

    }

    QGraphicsView* gView = qobject_cast<QGraphicsView*>(widget);

    if (gView) {

        // We don't want to focus to graphics view but the items inside the scene, so just return

        return;

    }

    // Check whether the editor has read-only constraint and reject focus

    // if so.

    bool readOnly = false;

    if (HbEditorInterface::isConnected(widget)) {

        HbEditorInterface eInt(widget);

        if (eInt.constraints() & HbEditorConstraintIgnoreFocus) {

            readOnly = true;

        }

    }

    // Focusing widget doesn't have input capabilities

    // or it is read-only.

    if (readOnly && HbInputFocusObject::isReadOnlyWidget(widget)) {

        if (d->mFocusObject) {

            focusLost();

        }

        return;

    }

    if (d->mFocusObject) {

        if (d->mFocusObject->object() == widget) {

            // Focus remains in same widget, do nothing.

            return;

        } else {

            // Lose editor focus unless we are focusing back to the editor from e.g. a vkb

            focusLost();

        }

    }

    bool refreshHost = false;

    // Delete previous focus object.

    if (d->mFocusObject) {

        refreshHost = true;

        disconnect(d->mFocusObject, SIGNAL(editorDeleted()), this, SLOT(editorDeleted()));

    }

    delete d->mFocusObject;

    d->mFocusObject = 0;

    // Attach focus.

    d->mFocusObject = new HbInputFocusObject(widget);

    connect(widget, SIGNAL(destroyed(QObject*)), this, SLOT(editorDeleted(QObject*)));

    d->setFocusCommon();

    // The focus jumped from one editor to another. Make sure that vkb host

    // updates the situation correctly.

    if (refreshHost && d->mFocusObject) {

        HbVkbHost *vkbHost = d->mFocusObject->editorInterface().vkbHost();

        if (vkbHost) {

            vkbHost->refresh();

        }

    }

}

/*!

Checks if the destroyed widget is currently focused and clears the focus

if needed. This method should not be overridden.

\sa focusObjectDestroyed

*/

void HbInputMethod::widgetDestroyed(QWidget* widget)

{

    Q_D(HbInputMethod);

    if (d->mFocusObject && d->mFocusObject->object() == widget) {

        releaseFocus();

    }

}

/*!

*/

void HbInputMethod::focusObjectDestroyed(const HbInputFocusObject* focusObject)

{

    Q_D(HbInputMethod);

    if (focusObject && focusObject == d->mFocusObject) {

        releaseFocus();

    }

}

/*!

Graphics item based editors (or any other object that implements

HbInputFocusObject) send their focus events notifications through this method.

\sa setFocusWidget

\sa HbInputFocusObject

*/

void HbInputMethod::setFocusObject(HbInputFocusObject* focusObject)

{

    Q_D(HbInputMethod);

    if (d->mFocusLocked) {

        return;

    }

    if (focusObject == 0) {

        // Losing focus.

        if (d->mFocusObject != 0) {

            focusLost(false);

            delete d->mFocusObject;

            d->mFocusObject = 0;

        }

        return;

    }

    if(d->compareWithCurrentFocusObject( focusObject )) {

       // The incoming focus object is either same or points to same

        // widget that the framework is already focused to and nothing needs to be done here.

        // But because the ownership of the focus object is transferred to the

        // the framework, we need to delete the the incoming focus object in case it is

        // dirrefent than current one.

        if (d->mFocusObject != focusObject) {

            delete focusObject;

        }

        return;

    }

    bool refreshHost = false;

    // Delete previous focus object.

    if (d->mFocusObject) {

        refreshHost = true;

        focusLost(true);

        disconnect(d->mFocusObject->object(), SIGNAL(destroyed(QObject*)), this, SLOT(editorDeleted(QObject*)));

        delete d->mFocusObject;

        d->mFocusObject = 0;

    }

    QInputContext::setFocusWidget(0);

    // Attach focus.

    d->mFocusObject = focusObject;

    connect(d->mFocusObject->object(), SIGNAL(destroyed(QObject*)), this, SLOT(editorDeleted(QObject*)));

    // If this is embedded QWidget, then set base class focus too.

    QWidget *widget = qobject_cast<QWidget*>(focusObject->object());

    if (widget) {

        QInputContext::setFocusWidget(widget);

    }

    d->setFocusCommon();

    // The focus jumped from one editor to another. Make sure that vkb host

    // updates the situation correctly.

    if (refreshHost && d->mFocusObject) {

        HbVkbHost *vkbHost = d->mFocusObject->editorInterface().vkbHost();