/*!

* Copyright (c) 2010 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: Provides information about remote party information of ongoing calls.

*

*/

#ifndef XQCALLREMOTEPARTYINFO_H

#define XQCALLREMOTEPARTYINFO_H

#include <QObject>

#include <QString>

#include <QGlobal.h>

#include <ccpdefs.h>

#include <mcallremotepartyinfo.h>

// forward declarations 

class XQCallRemotePartyInfoPrivate;

class CallRemotePartyInfoPrivate;

/*!

    CallRemotePartyInfo

    Holds calls remote party information.

*/

NONSHARABLE_CLASS( CallRemotePartyInfo )

    {

public:

    /*!

       Constructors and destructor

    */

    CallRemotePartyInfo();

    CallRemotePartyInfo(const CallRemotePartyInfo&);

    CallRemotePartyInfo& operator=(const CallRemotePartyInfo&);

    ~CallRemotePartyInfo();

public:

    void setCallIndex(int index); 

    void setAddress(QString address); 

    void setMatchedName(QString matchedName); 

    void setNameFromNetwork(QString nameFromNetwork); 

    void setCompanyName(QString companyName); 

    void setSATCall(bool SATCall); 

    void setRemoteIdentity(MCallRemotePartyInfo::TRemoteIdentityStatus remoteIdentity); 

    int callIndex() const;  

    QString address() const;

    QString matchedName() const ; 

    QString nameFromNetwork() const; 

    QString companyName() const; 

    bool SATCall() const; 

    MCallRemotePartyInfo::TRemoteIdentityStatus remoteIdentity() const;

protected:  

    CallRemotePartyInfoPrivate* d_ptr;  

    };

#ifdef BUILD_XQCALLREMOTEPARTYINFO

#define XQCALLREMOTEPARTYINFO_EXPORT Q_DECL_EXPORT

#else

#define XQCALLREMOTEPARTYINFO_EXPORT Q_DECL_IMPORT

#endif

/*!

    XQCallRemotePartyInfo

    Class to be used for receiving information about ongoing call remote party informations.

    Usage example:

    QList<CallRemotePartyInfo> infos;

    CallRemotePartyInfo callRemotePartyInfoFirst;

    CallRemotePartyInfo callRemotePartyInfoLast;

    XQCallRemotePartyInfo xqCallRemotePartyInfo;

    xqCallRemotePartyInfo.getCallRemotePartyInfos(infos);

    callRemotePartyInfoFirst = infos.first();

    callRemotePartyInfoLast = infos.last();

*/

class XQCALLREMOTEPARTYINFO_EXPORT XQCallRemotePartyInfo: public QObject

{

    Q_OBJECT

public: 

    /*!

       Constructor and destructor

    */

    XQCallRemotePartyInfo ();

    ~XQCallRemotePartyInfo ();

    /*!

        \fn void getCallRemotePartyInfos(QList<CallRemotePartyInfo> &infos)

        Gets the snapshot of remote party information of ongoing calls.

    */

    void getCallRemotePartyInfos(QList<CallRemotePartyInfo> &infos);

signals:

    /*!

        \fn void callRemotePartyInformationChanged()

        Signals that there are changes in remote party informations of ongoing calls. 

        Client should fetch the call infomations after receiving the notification.

    */

    void callRemotePartyInformationChanged();

private slots:       

/*!

        \fn void sendCallRemotePartyInfoChangedSignal()

        Sends signal call remote party info changed signal to client's.

    */

    void sendCallRemotePartyInfoChangedSignal();

protected:  

     XQCallRemotePartyInfoPrivate* const d_ptr;  

     Q_DECLARE_PRIVATE(XQCallRemotePartyInfo);  

};

#endif // XQCALLREMOTEPARTYINFO_H