1 /*!

     2 * Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description: Implements Qt Highway provider for key sequence handling.

    15 *

    16 */

    17 

    18 #ifndef KEYSEQUENCERECOGNITIONPROVIDER_H

    19 #define KEYSEQUENCERECOGNITIONPROVIDER_H

    20 

    21 #include <xqserviceprovider.h>

    22 

    23 class KeySequenceHandler;

    24 

    25 class KeySequenceRecognitionProvider : public XQServiceProvider

    26 {

    27     Q_OBJECT

    28 

    29 public:

    30 

    31     KeySequenceRecognitionProvider(QObject *parent = 0);

    32     ~KeySequenceRecognitionProvider();

    33     

    34 public slots:

    35     

    36     /*!

    37         \fn keySequenceValidator()

    38         

    39         Returns regular expression for key sequence validation. Client must 

    40         validate sequence before requesting provider to execute it. Regular

    41         expression is in escaped format.

    42         

    43         \return Escaped regular expression.

    44         

    45         Usage example:

    46         XQAiwRequest *request = mAiwMgr.create(

    47             "com.nokia.symbian.IKeySequenceRecognition",

    48             "keySequenceValidator()", 

    49             true);

    50         

    51         QVariant keySequenceValidator;

    52         bool requestOk = request->send(keySequenceValidator);

    53         if (requestOk && keySequenceValidator.toString().size()) {

    54             QString expression = keySequenceValidator.toString();

    55             mValidator = new QRegExp(expression);

    56         }

    57     */

    58     QString keySequenceValidator();

    59     

    60     /*!

    61         \fn executeKeySequence(const QString& keySequence)

    62         

    63         Client can use this method to execute key sequence.

    64         Key sequence may contain for example product codes etc. that

    65         may cause lower layers to do any specific things.

    66         

    67         \param  keySequence          Key sequence to execute.

    68         \return True if key sequence was processed, false otherwise.

    69         

    70         Usage example:

    71         XQAiwRequest *request = mAiwMgr.create(

    72             "com.nokia.symbian.IKeySequenceRecognition",

    73             "executeKeySequence(QString)", 

    74             true);

    75         

    76         QList<QVariant> arguments;

    77         arguments << "*#0000#";

    78         request->setArguments(arguments);

    79         

    80         QVariant keySequenceProcessed;

    81         bool requestOk = request.send(keySequenceProcessed);

    82     */

    83     bool executeKeySequence(const QString &keySequence);

    84 

    85 private:

    86     void setupLocalization();

    87     void constructKeySequenceHandlers();

    88     void constructKeySequenceValidator();

    89     

    90 private:

    91     QString m_keySequenceValidator;

    92     QList<KeySequenceHandler*> m_handlers;

    93 };

    94 

    95 #endif // KEYSEQUENCERECOGNITIONPROVIDER_H