/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/
#ifndef LOGSSERVICES_H
#define LOGSSERVICES_H

#include <QString>
#include <logsexport.h> 

/**
* Logs application services
* @deprecated  Use XQApplicationManager instead. 
*  Service name: "logs",
*  Interface name: "com.nokia.symbian.ILogsView"
*  Operation signature: "show(QVariantMap)" 
*  
*  @deprecated don't use parameters below, they will be replaced (see xqaiwdecl.h mcl_w28-30)  
*  Operation parameters: 
*     "view_index": int, 0 - all recent, 1 - received, 2 - called, 3 - missed
*     "show_dialpad": bool, if true view is shown with dialpad opened on top
*     "dialpad_text": QString, number to be prefilled into dialpad
*          
*  New params:
*     XQLOGS_VIEW_INDEX: "ViewIndex": int, 0 - all recent, 1 - received, 2 - called, 3 - missed
*     XQLOGS_SHOW_DIALPAD: "ShowDialpad": bool, if true view is shown with dialpad opened on top
*     XQLOGS_DIALPAD_TEXT: "DialpadText": QString, number to be prefilled into dialpad      
*            
*  Example usage:
*  XQApplicationManager appMgr;
*  QScopedPointer<XQAiwRequest> request(appMgr.create(XQI_LOGS_VIEW, XQOP_LOGS_SHOW, false));   
*  if (!request.isNull()) {
*      int retValue = -1; 
*      QList<QVariant> arglist;
*      QVariantMap map;
*      map.insert(XQLOGS_VIEW_INDEX, QVariant((int)XQService::LogsViewMissed));
*      map.insert(XQLOGS_SHOW_DIALPAD, QVariant(true));
*      map.insert(XQLOGS_DIALPAD_TEXT, QVariant(QString()));
*      arglist.append(QVariant(map));
*      request->setArguments(arglist);
*      QVariant ret(retValue);        
*      request->send(ret);
*  }
*
*/
class LogsServices
{
    public:
    
    //Deprecated
    enum LogsView{
        ViewAll,
        ViewReceived,
        ViewCalled,
        ViewMissed
    };
    /**
     * Requests to start Logs application. If Logs is already running,
     * activates the requested view.
     * 
     * @deprecated Use "com.nokia.symbian.ILogsView" interface 
     * and "show(int,bool,QString)" operation instead
     *
     * @param activatedView   The view to be activated in Logs.
     * @param showDialpad     Specifies whether dialpad should be shown on top
     *                        of the activated view
     * @param number          Predefined number for dialpad
     * @return 0 if started/activated succesfully
     */
    LOGSSERVICES_EXPORT static int start(
        LogsView activatedView, bool showDialpad, const QString& number = QString());

};


#endif  //LOGSSERVICES_H