src/hbinput/inputwidgets/hbinputhwtoolcluster.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 19 Apr 2010 14:02:13 +0300
changeset 0 16d8024aca5e
child 1 f7ac710697a9
permissions -rw-r--r--
Revision: 201011 Kit: 201015

/****************************************************************************
**
** 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 HbInput 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 <QGraphicsGridLayout>

#include <hbaction.h>
#include <hbinputmethod.h>
#include <hbinpututils.h>
#include <hbinputvkbhost.h>
#include <hbinputsettingproxy.h>
#include <hbinputsettingdialog.h>
#include <hbinputcommondialogs.h>

#include "hbinputvkbwidget_p.h"
#include "hbinputhwtoolcluster.h"
#include "hbinputtouchkeypadbutton.h"
#include "hbinputmodeindicator.h"

const QString HbCustomButtonObjName = "Mini VKB custom button ";

const int HbMiniVirtualKeypadNumberOfColumn = 5;
const qreal HbMiniVirtualKeypadReductionFactor = 4.5;

/*!
@proto
@hbinput
\class HbHwToolCluster
\brief Implementation of hardware tool cluster.

Implementation of hardware tool cluster.

\sa HbHwToolCluster
\sa HbTouchKeypadButton
*/

/// @cond

class HbHwToolClusterPrivate : HbInputVkbWidgetPrivate
{
    Q_DECLARE_PUBLIC(HbHwToolCluster)

public:
    HbHwToolClusterPrivate();
    ~HbHwToolClusterPrivate();
public:
    HbTouchKeypadButton *mLanguageButton;
    HbTouchKeypadButton *mInputMethodButton;
    HbTouchKeypadButton *mPredictionIndicatorButton;
};

HbHwToolClusterPrivate::HbHwToolClusterPrivate() : mLanguageButton(0),
                mInputMethodButton(0),
                mPredictionIndicatorButton(0)
{
}

HbHwToolClusterPrivate::~HbHwToolClusterPrivate()
{
}

/// @endcond

/*!
Constructs the object.
*/
HbHwToolCluster::HbHwToolCluster(HbInputMethod* owner,
                                       QGraphicsItem* parent)
                                       : HbInputVkbWidget(*new HbHwToolClusterPrivate, parent)
{
    if (0 == owner) {
        return;
    }
    Q_D(HbHwToolCluster);
    d->q_ptr = this;
    d->mOwner = owner;
}

/*!
Creates the layout of the mini touch keypad for hardware qwerty.
*/
void HbHwToolCluster::createLayout()
{
    setupToolCluster();

    Q_D(HbHwToolCluster);
    // The layout is already created. So just return.
    if ( d->mButtonLayout ) {
        return;
    }

    d->mButtonLayout = new QGraphicsGridLayout();
    setContentsMargins(0.0, 0.0, 0.0, 0.0);
    d->mButtonLayout->setContentsMargins(0.0, 0.0, 0.0, 0.0);
    d->mButtonLayout->setHorizontalSpacing(HorizontalSpacing);
    d->mButtonLayout->setVerticalSpacing(VerticalSpacing);
    d->mButtonLayout->addItem(d->mSettingsButton, 0, 0);   // Settings key
    d->mButtonLayout->addItem(d->mLanguageButton, 0, 1);   // language selection
    d->mButtonLayout->addItem(d->mPredictionIndicatorButton, 0, 2);   // prediction indicator
    d->mButtonLayout->addItem(d->mInputMethodButton, 0, 3);   //input method selection key
    d->mButtonLayout->addItem(d->mApplicationButton, 0, 4);   // Application specific key

    d->mSettingsButton->setObjectName( HbCustomButtonObjName + QString::number(1));
    d->mApplicationButton->setObjectName( HbCustomButtonObjName + QString::number(2));
    d->mLanguageButton->setObjectName( HbCustomButtonObjName + QString::number(3));
    d->mInputMethodButton->setObjectName( HbCustomButtonObjName + QString::number(4));
    d->mPredictionIndicatorButton->setObjectName( HbCustomButtonObjName + QString::number(5));

    connect(d->mInputMethodButton, SIGNAL(clicked()), this, SLOT(showMethodDialog()));
    connect(d->mLanguageButton, SIGNAL(clicked()), this, SLOT(showLanguageDialog()));
    connect(d->mPredictionIndicatorButton, SIGNAL(clicked()), HbInputSettingProxy::instance(), SLOT(togglePrediction()));
}


/*!
Creates the tools cluster for mini VKB layout.
*/
void HbHwToolCluster::setupToolCluster()
{
    Q_D(HbHwToolCluster);
    if(!d->mOwner || !d->mOwner->focusObject()) {
        return;
    }

    // Create buttons if they do not exist
    if (!d->mSettingsButton) {
        d->mSettingsButton = new HbTouchKeypadButton(this, QString(""));
        d->mSettingsButton->setIcon(HbIcon(settingsIcon));
        d->mSettingsButton->setButtonType(HbTouchKeypadButton::HbTouchButtonFunction);
        d->mSettingsButton->setBackgroundAttributes(HbTouchKeypadButton::HbTouchButtonReleased);

        connect(d->mSettingsButton, SIGNAL(clicked()), this, SLOT(showSettingsDialog()));
    }
    if(!d->mLanguageButton) {
        d->mLanguageButton = new HbTouchKeypadButton(this, QString(""));
        d->mLanguageButton->setButtonType(HbTouchKeypadButton::HbTouchButtonFunction);
        d->mLanguageButton->setBackgroundAttributes(HbTouchKeypadButton::HbTouchButtonReleased);
    }

    if(!d->mInputMethodButton) {
        d->mInputMethodButton = new HbTouchKeypadButton(this, QString(""));
        d->mInputMethodButton->setIcon(HbIcon(inputMethodIcon));
        d->mInputMethodButton->setButtonType(HbTouchKeypadButton::HbTouchButtonFunction);
        d->mInputMethodButton->setBackgroundAttributes(HbTouchKeypadButton::HbTouchButtonReleased);
    }

    if(!d->mPredictionIndicatorButton) {
        d->mPredictionIndicatorButton = new HbTouchKeypadButton(this, QString(""));
        d->mPredictionIndicatorButton->setButtonType(HbTouchKeypadButton::HbTouchButtonFunction);
        d->mPredictionIndicatorButton->setBackgroundAttributes(HbTouchKeypadButton::HbTouchButtonReleased);
        d->mInputModeIndicator = new HbInputModeIndicator(*d->mPredictionIndicatorButton, this);
    } else {
        d->mInputModeIndicator->updateIndicator();
    }

    if(d->mLanguageButton) {
        // update language button text
        QString langName = HbInputSettingProxy::instance()->globalInputLanguage().localisedName();
        langName.truncate(3);
        d->mLanguageButton->setText(langName);
    }

    // update prediction button status
    if (HbInputSettingProxy::instance()->predictiveInputStatus()) {
        d->mPredictionIndicatorButton->setIcon(HbIcon(predictionOffIcon));
    } else {
        d->mPredictionIndicatorButton->setIcon(HbIcon(predictionOnIcon));
    }

    // If there's a application specific button defined, create new button with the properties
    // or update the existing one. Otherwise create an empty button or clean the properties of an existing one.
    if (!d->mOwner->focusObject()->editorInterface().actions().isEmpty()) {
        QList<HbAction*> actions = d->mOwner->focusObject()->editorInterface().actions();
        if (d->mApplicationButton) {
            d->mApplicationButton->setText(actions.first()->text());
            d->mApplicationButton->disconnect(SIGNAL(clicked()));
        } else {
            d->mApplicationButton = new HbTouchKeypadButton(this, actions.first()->text());
            d->mApplicationButton->setButtonType(HbTouchKeypadButton::HbTouchButtonFunction);
            d->mApplicationButton->setBackgroundAttributes(HbTouchKeypadButton::HbTouchButtonReleased);
        }
        connect(d->mApplicationButton, SIGNAL(clicked()), actions.first(), SLOT(trigger()));
        d->mApplicationButton->setIcon(actions.first()->icon());
        d->mApplicationButton->setToolTip(actions.first()->toolTip());
    } else {
        if (d->mApplicationButton) {
            d->mApplicationButton->disconnect(SIGNAL(clicked()));
            d->mApplicationButton->setText(QString());
            d->mApplicationButton->setIcon(HbIcon());
            d->mApplicationButton->setToolTip(QString());
        } else {
            d->mApplicationButton = new HbTouchKeypadButton(this, QString());
            d->mApplicationButton->setButtonType(HbTouchKeypadButton::HbTouchButtonFunction);
            d->mApplicationButton->setBackgroundAttributes(HbTouchKeypadButton::HbTouchButtonReleased);
        }
    }
}

/*!
Returns keyboard type.
*/
HbKeyboardType HbHwToolCluster::keyboardType() const
{
    return HbKeyboardQwerty;
}

/*!
Destructs the object.
*/
HbHwToolCluster::~HbHwToolCluster()
{
}

/*!
This is called right before the keypad is about to open. The layout of the
keypad happens here.
*/
void HbHwToolCluster::aboutToOpen(HbVkbHost *host)
{
    Q_D(HbHwToolCluster);
    HbInputVkbWidget::aboutToOpen(host);

    QSizeF size = preferredKeyboardSize();
    qreal height = size.height() - HbCloseHandleHeight;

    qreal width = size.width() / (qreal)HbMiniVirtualKeypadNumberOfColumn;
    for (int i=0; i < HbMiniVirtualKeypadNumberOfColumn ;i++) {
        d->mButtonLayout->setColumnFixedWidth(i, width);
    }
    //There is only one row
    d->mButtonLayout->setRowFixedHeight(0, height);
}

/*!
Returns preferred keyboard size. HbVkbHost uses this information when it opens the keyboard.
*/
QSizeF HbHwToolCluster::preferredKeyboardSize()
{
    Q_D(HbHwToolCluster);
    QSizeF ret = QSizeF(0.0, 0.0);

    if (d->mCurrentHost) {
        QSizeF ret;
        //Get the available keypad area from the VKB host
        ret = d->mCurrentHost->keyboardArea();
        //Since this is a mini VKB, it has a lesser size than the available
        //area for the keypad.
        ret.setHeight(ret.height()/HbMiniVirtualKeypadReductionFactor);
        return ret;
    }

    return ret;
}

/*!
Shows the settings dialog
*/
void HbHwToolCluster::showSettingsDialog()
{
    Q_D(HbHwToolCluster);

    HbInputSettingDialog::HbSettingItems items = HbInputSettingDialog::HbSettingItemAll;
    if(d->mOwner->focusObject() && d->mOwner->focusObject()->editorInterface().isNumericEditor()){
        items &=  (~HbInputSettingDialog::HbSettingItemPrediction);
    }
    HbInputSettingDialog* settings = new HbInputSettingDialog(items);
    settings->exec();
    delete settings;
}

/*!
Shows the input method selection dialog.
*/
void HbHwToolCluster::showMethodDialog()
{
    Q_D(HbHwToolCluster);

    HbInputMethodDescriptor method
        = HbInputCommonDialogs::showCustomInputMethodSelectionDialog(HbInputSettingProxy::instance()->globalInputLanguage());
    if (!method.isEmpty() && d->mOwner) {
        d->mOwner->activateInputMethod(method);
    }
}

/*!
Shows the language selection dialog.
*/
void HbHwToolCluster::showLanguageDialog()
{
    HbInputLanguage language =
        HbInputCommonDialogs::showLanguageSelectionDialog(HbInputSettingProxy::instance()->globalInputLanguage().language());
    HbInputSettingProxy::instance()->setGlobalInputLanguage(language);
}

// End of file