phoneengine/phoneservices/inc/dialservicedepricated.h
changeset 30 ebdbd102c78a
child 50 377c906a8701
equal deleted inserted replaced
27:2f8f8080a020 30:ebdbd102c78a
       
     1 /*!
       
     2 * Copyright (c) 2009 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:  Dial API to be used through Qt Highway.
       
    15 *               THIS IS DEPRICATED API - DO NOT USE!
       
    16 *               (use DialService instead)
       
    17 *
       
    18 */
       
    19 
       
    20 #ifndef DIALSERVICEDEPRICATED_H
       
    21 #define DIALSERVICEDEPRICATED_H
       
    22 
       
    23 #include <QObject>
       
    24 #include <QString>
       
    25 #include <xqserviceprovider.h>
       
    26 #include "mpecallcontrolif.h"
       
    27 #include "mpecallsettersif.h"
       
    28 
       
    29 class DialServiceDepricated : public XQServiceProvider
       
    30 {
       
    31     Q_OBJECT
       
    32 public:
       
    33     DialServiceDepricated(MPECallControlIF &call, MPECallSettersIF &parameters, QObject *parent = 0);
       
    34     ~DialServiceDepricated();
       
    35     
       
    36 public slots:
       
    37     /*!
       
    38         \fn dial(const QString& number)
       
    39         
       
    40         This method makes a cellular switched dial command to
       
    41         Phone Application. It is intended to be used via Qt Highway.
       
    42         
       
    43         Usage example:
       
    44         XQServiceRequest snd("com.nokia.services.telephony","dial(QString)");
       
    45         snd << "0501234567";        
       
    46     */
       
    47     int dial(const QString& number);
       
    48     
       
    49     /*!
       
    50         \fn dial(const QString& number)
       
    51         
       
    52         This method makes a cellular switched dial command to
       
    53         Phone Application. It is intended to be used via Qt Highway.
       
    54         Caller's name is shown according to the given Phonebook contact
       
    55         identifier.
       
    56         
       
    57         Usage example:
       
    58         XQServiceRequest snd("com.nokia.services.telephony","dial(QString,int)");
       
    59         snd << "0501234567" << 123456;        
       
    60     */
       
    61     int dial(const QString& number, int contactId);
       
    62     
       
    63     /*!
       
    64         \fn dialVideo(const QString& number)
       
    65         
       
    66         This method makes a video call dial command to
       
    67         Phone Application. It is intended to be used via Qt Highway.
       
    68         
       
    69         Usage example:
       
    70         XQServiceRequest snd("com.nokia.services.telephony","dial(QString)");
       
    71         snd << "0501234567";        
       
    72     */
       
    73     void dialVideo(const QString& number);
       
    74 
       
    75     /*!
       
    76         \fn dial(const QString& number)
       
    77         
       
    78         This method makes a video call dial command to
       
    79         Phone Application. It is intended to be used via Qt Highway.
       
    80         Caller's name is shown according to the given Phonebook contact
       
    81         identifier.
       
    82         
       
    83         Usage example:
       
    84         XQServiceRequest snd("com.nokia.services.telephony","dial(QString,int)");
       
    85         snd << "0501234567" << 123456;        
       
    86     */
       
    87     void dialVideo(const QString& number, int contactId);
       
    88     
       
    89     /*!
       
    90         \fn dialVoip(const QString& address)
       
    91         
       
    92         This method makes a voip call dial command to
       
    93         Phone Application. It is intended to be used via Qt Highway.
       
    94         
       
    95         Usage example:
       
    96         XQServiceRequest snd("com.nokia.services.telephony","dialVoip(QString)");
       
    97         snd << "address@domain";        
       
    98     */
       
    99     void dialVoip(const QString& address);
       
   100     
       
   101     /*!
       
   102         \fn dialVoip(const QString& address, int contactId)
       
   103         
       
   104         This method makes a voip call dial command to
       
   105         Phone Application. It is intended to be used via Qt Highway.
       
   106         Caller's name is shown according to the given Phonebook contact
       
   107         identifier.
       
   108         
       
   109         Usage example:
       
   110         XQServiceRequest snd("com.nokia.services.telephony","dialVoip(QString,int)");
       
   111         snd << "address@domain" << 123456;        
       
   112     */
       
   113     void dialVoip(const QString& address, int contactId);
       
   114     
       
   115     /*!
       
   116         \fn dialVoipService(const QString& address, int contactId)
       
   117         
       
   118         This method makes a voip call dial command to
       
   119         Phone Application. It is intended to be used via Qt Highway.
       
   120         Call is made by given service (id).
       
   121         
       
   122         Usage example:
       
   123         XQServiceRequest snd("com.nokia.services.telephony","dialVoipService(QString,int)");
       
   124         snd << "address@domain" << 123;        
       
   125     */
       
   126     void dialVoipService(const QString& address, int serviceId);
       
   127     
       
   128     /*!
       
   129         \fn dialVoipService(const QString& address, int serviceId, int contactId)
       
   130         
       
   131         This method makes a voip call dial command to
       
   132         Phone Application. It is intended to be used via Qt Highway.
       
   133         Call is made by given service (id).
       
   134         Caller's name is shown according to the given Phonebook contact
       
   135         identifier.
       
   136         
       
   137         Usage example:
       
   138         XQServiceRequest snd("com.nokia.services.telephony","dialVoipService(QString,int,int)");
       
   139         snd << "address@domain" << 123 << 12345;        
       
   140     */
       
   141     void dialVoipService(const QString& address, int serviceId, int contactId);
       
   142     
       
   143 private:
       
   144     /*!
       
   145         \fn QString simplified(QString& number)
       
   146         
       
   147         Returns a string that has whitespaces, '(', ')', '-', '[', and ']' chars removed 
       
   148     */
       
   149     static QString simplified(const QString &number) Q_REQUIRED_RESULT;
       
   150 
       
   151 
       
   152 private:
       
   153     MPECallControlIF &m_call;
       
   154     MPECallSettersIF &m_parameters;    
       
   155 };
       
   156 
       
   157 #endif // DIALERSERVICEDEPRICATED_H