/*
* Copyright (c) 2007 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:   Vcc P&S property manager
*
*/




#ifndef C_VCCPSPROPERTY_H
#define C_VCCPSPROPERTY_H

#include <e32base.h>
#include <e32std.h>
#include <e32property.h>

#include <vccsubscribekeys.h>

/**
 *  CVccUiPsProperty manages the VCC P&S keys on the UI side:
 *
 *  This class defines the VCC property keys used by the UI.
 *  It provides access to read/write values. Keys can be deleted.
 *
 *  Key KVccPropKeyHoRequest:
 *      EVccNoRequestOngoing                idle state
 *      EVccManualStartCsToPsHoRequest      manual HO PS->CS
 *      EVccManualCancelCsToPsHoRequest     manual HO CS->PS
 *      EVccUndefinedRequest                P&S key not available
 *
 *  @code
 *      CVccUiPsProperty* iVccPsp = CVccUiPsProperty::NewL();
 *      ...
 *      iVccPsp.NotifySubscriberL(EVccManualStartCsToPsHoRequest);
 *      ...
 *      iVccPsp.NotifySubscriberL(EVccManualCancelCsToPsHoRequest);
 *      ...
 *      delete iVccPsp;
 *  @endcode
 *
 *
 *  @lib vccuipropertyhandler.lib
 *  @since S60 v3.2
 */
class CVccUiPsProperty : public CBase
{
public:

    /**
     * Two-phased constructor.
     *
     * Defines UI side VCC property keys if they are not available.
     */
    IMPORT_C static CVccUiPsProperty* NewL();

    /**
     * Destructor.
     * Note! Deletes Vcc UI side property keys
     */
    IMPORT_C virtual ~CVccUiPsProperty();

    /**
     * Update VCC property key KVccPropKeyHoRequest with the given value.
     *
     *  @since S60 v3.2
     * @param aValue The new value
     */
    IMPORT_C void NotifySubscriberL( TVccHoRequest aValue );

    /**
     * Gets the current value of the Vcc property key KVccPropKeyHoRequest.
     *
    *  @since S60 v3.2
     * @param aValue The value of the key
     * @return KErrNone / KErrPermissionDenied/ KErrNotFound/KErrArgument
     */
    IMPORT_C TInt GetCurrentRequest( TVccHoRequest& aValue );

    /**
     * Deletes keys used by UI
     */
    IMPORT_C TInt DeleteKeys();

private:
    /**
     * C++ Constructor
     */
    CVccUiPsProperty();

    /**
     * Symbian 2nd phase Constructor
     */
    void ConstructL();

    /**
     * Defines keys used by UI
     */
    void DefineKeysL();

    /**
     * creates handles to property keys used by UI
     */
    void CreateHandlesL();

private: //data

    /**
     * Handle to property which is updated by the UI
     * Own
     */
    RProperty iHoRequestKey;
};

#endif /*C_VCCPSPROPERTY_H*/