1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (developer.feedback@nokia.com)

     6 **

     7 ** This file is part of the HbInput module of the UI Extensions for Mobile.

     8 **

     9 ** GNU Lesser General Public License Usage

    10 ** This file may be used under the terms of the GNU Lesser General Public

    11 ** License version 2.1 as published by the Free Software Foundation and

    12 ** appearing in the file LICENSE.LGPL included in the packaging of this file.

    13 ** Please review the following information to ensure the GNU Lesser General

    14 ** Public License version 2.1 requirements will be met:

    15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    16 **

    17 ** In addition, as a special exception, Nokia gives you certain additional

    18 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    20 **

    21 ** If you have questions regarding the use of this file, please contact

    22 ** Nokia at developer.feedback@nokia.com.

    23 **

    24 ****************************************************************************/

    25 

    26 #ifndef HB_INPUT_VKB_WIDGET_H

    27 #define HB_INPUT_VKB_WIDGET_H

    28 

    29 #include <hbdialog.h>

    30 #include <hbinputdef.h>

    31 #include <hbinputvirtualkeyboard.h>

    32 #include <hbinputvirtualrocker.h>

    33 

    34 const int HbRepeatTimeout = 1000;

    35 const int HbRepeatTimeoutShort = 150;

    36 

    37 const QString backgroundGraphics("qtg_fr_input_bg");

    38 const QString HbInputVkbHandleIcon("qtg_graf_input_swipe");

    39 const qreal HbCloseHandleHeight = 20.0;

    40 

    41 class HbInputVkbWidgetPrivate;

    42 class HbAction;

    43 class HbInputMethod;

    44 class HbView;

    45 class HbKeymap;

    46 

    47 class HB_INPUT_EXPORT HbInputVkbWidget : public HbWidget, public HbVirtualKeyboard

    48 {

    49     Q_OBJECT

    50 

    51 public:

    52     enum HbFlickDirection 

    53     {

    54         HbFlickDirectionNone = 0,

    55         HbFlickDirectionLeft,

    56         HbFlickDirectionRight,

    57         HbFlickDirectionUp,

    58         HbFlickDirectionDown

    59     };

    60 

    61     enum HbVkbCloseMethod

    62     {

    63         HbVkbCloseMethodButtonDrag = 0x1,

    64         HbVkbCloseMethodCloseButton = 0x2,

    65         HbVkbCloseMethodCloseButtonDrag = HbVkbCloseMethodCloseButton | HbVkbCloseMethodButtonDrag,

    66         HbVkbCloseMethodCloseGesture = 0x4,

    67     };

    68 

    69      enum HbSctView {

    70         HbSctViewSpecialCharacter,

    71         HbSctViewSmiley

    72     };

    73     

    74     HbInputVkbWidget(QGraphicsItem *parent = 0);

    75     virtual ~HbInputVkbWidget();

    76     virtual HbFlickDirection flickDirection();

    77 

    78 public: // From HbVirtualKeyboard

    79     QWidget* asWidget();

    80     QGraphicsWidget* asGraphicsWidget();

    81     QSizeF preferredKeyboardSize();

    82     QSizeF minimizedKeyboardSize();

    83     virtual void aboutToOpen(HbVkbHost *host);

    84     virtual void aboutToClose(HbVkbHost *host);

    85     virtual void keyboardOpened(HbVkbHost *host);

    86     virtual void keyboardClosed(HbVkbHost *host);

    87     virtual void keyboardMinimized(HbVkbHost *host);

    88     virtual void keyboardAnimationFrame(HbVkbAnimationType type, qreal x);

    89 

    90     virtual void setKeymap(const HbKeymap* keymap);

    91 

    92     virtual void setMode(HbKeypadMode mode, HbModifiers modifiers);

    93     virtual HbKeypadMode mode() const;

    94     virtual HbModifiers modifiers() const;

    95     virtual void setupToolCluster();

    96 

    97     virtual void setRockerVisible(bool visible);

    98     virtual bool isRockerVisible() const;

    99 

   100     virtual void setKeyboardDimmed(bool dimmed);

   101     virtual void setBackgroundDrawing(bool backgroundEnabled);

   102     virtual QList<HbKeyPressProbability> probableKeypresses();

   103     virtual void animKeyboardChange();

   104 

   105 

   106 protected: // From QGraphicsItem

   107     virtual QPainterPath shape () const;

   108     virtual void mousePressEvent(QGraphicsSceneMouseEvent* aEvent); 

   109     virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent* aEvent);

   110     virtual void changeEvent(QEvent *event);

   111     virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget);

   112     virtual int type() const { return Hb::ItemType_InputVkbWidget; }

   113     QSizeF sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const;

   114 

   115 protected:

   116     // layout

   117     virtual QGraphicsLayout *keypadLayout();

   118     QSizeF keypadButtonAreaSize();

   119 

   120 public slots:

   121     void showSettingList();

   122     void executeSettingsDialog();

   123     void executeMethodDialog();

   124     void closeSettingList();

   125     void mappedKeyPress(int aButtonId);

   126     void mappedKeyRelease(int aButtonId);

   127     void settingsClosed();

   128     void togglePredictionStatus();

   129     void showSmileyPicker(int rows, int columns);

   130 

   131     void refreshApplicationButton();

   132     void keypadLanguageChangeAnimationUpdate(qreal aValue);

   133     void keypadLanguageChangeFinished();

   134 

   135 signals:

   136     void keypadCloseEventDetected(HbInputVkbWidget::HbVkbCloseMethod closeMethod);

   137     void rockerDirection(int aDirection, HbInputVirtualRocker::RockerSelectionMode aSelectionMode);

   138     void flickEvent(HbInputVkbWidget::HbFlickDirection direction);

   139     void smileySelected(QString text);

   140     void mouseMovedOutOfButton();

   141 protected:

   142     HbInputVkbWidget(HbInputVkbWidgetPrivate &dd, QGraphicsItem* parent); 

   143 

   144 private:

   145     Q_DECLARE_PRIVATE_D(d_ptr, HbInputVkbWidget)

   146     Q_DISABLE_COPY(HbInputVkbWidget)

   147 

   148     friend class HbTouchKeypadButton;

   149     friend class HbInputUsedSymbolPane;

   150 };

   151 

   152 #endif // HB_INPUT_VKB_WIDGET_H

   153 

   154 // End of file