phoneengine/phoneservices/inc/keysequencerecognitionservicedepricated.h
branchGCC_SURGE
changeset 51 f39ed5e045e0
parent 40 bab96b7ed1a4
parent 46 bc5a64e5bc3c
equal deleted inserted replaced
40:bab96b7ed1a4 51:f39ed5e045e0
     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:  Provides key sequence recognition and execution services.
       
    15 *               THIS IS DEPRICATED API - DO NOT USE!
       
    16 *               (use KeySequenceRecognitionService instead)
       
    17 *
       
    18 */
       
    19 
       
    20 #ifndef KEYSEQUENCERECOGNITIONSERVICEDEPRICATED_H
       
    21 #define KEYSEQUENCERECOGNITIONSERVICEDEPRICATED_H
       
    22 
       
    23 #include <QObject>
       
    24 #include <QString>
       
    25 #include <xqserviceprovider.h>
       
    26 
       
    27 class MPEKeySequenceRecognitionIF;
       
    28 
       
    29 class KeySequenceRecognitionServiceDepricated : public XQServiceProvider
       
    30 {
       
    31     Q_OBJECT
       
    32 
       
    33 public:
       
    34 
       
    35     KeySequenceRecognitionServiceDepricated(
       
    36         MPEKeySequenceRecognitionIF &keySequenceRecognizer,
       
    37         QObject *parent = 0);
       
    38     
       
    39     ~KeySequenceRecognitionServiceDepricated();
       
    40     
       
    41 public slots:
       
    42     
       
    43     /*!
       
    44         \fn executeKeySequence(const QString& keySequence)
       
    45         
       
    46         Client can use this method to execute key sequence recognition.
       
    47         Key sequence may contain for example product codes etc. that
       
    48         may cause lower layers to do any specific things.
       
    49 
       
    50         If sequence isn't recognized this method doesn't do anything.
       
    51         If sequence is recognized then task related to the code is executed.
       
    52         \param  keySequence          Key sequence to execute.
       
    53         \return True if key sequence was processed, false otherwise.
       
    54         
       
    55         Usage example:
       
    56         XQServiceRequest request(
       
    57             "com.nokia.services.telephony",
       
    58             "executeKeySequence(QString)",
       
    59             true);
       
    60         request << "*#0000#";
       
    61         QVariant keySequenceProcessed;
       
    62         bool requestOk = request.send(keySequenceProcessed);
       
    63     */
       
    64     bool executeKeySequence(const QString &keySequence);
       
    65     
       
    66 private:
       
    67     
       
    68     MPEKeySequenceRecognitionIF &m_keySequenceRecognizer;
       
    69 };
       
    70 
       
    71 #endif // KEYSEQUENCERECOGNITIONSERVICEDEPRICATED_H