src/hbinput/inputwidgets/hbinputhwtoolcluster.cpp
changeset 0 16d8024aca5e
child 1 f7ac710697a9
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/hbinput/inputwidgets/hbinputhwtoolcluster.cpp	Mon Apr 19 14:02:13 2010 +0300
@@ -0,0 +1,317 @@
+/****************************************************************************
+**
+** 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
+