/*
* Copyright (c) 2002 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:  Definition of CPropertyValuePair class.
*
*/


#ifndef PROPERTYVALUEPAIR_H
#define PROPERTYVALUEPAIR_H

// INCLUDE FILES

#include <e32base.h>

// FORWARD DECLARATIONS

class RWriteStream;
class RReadStream;

/**
* Class used by CInstalledAppsRegistryEntry. This class is not exposed
* outside of the entry. It contains a single Language/Package/Vendor triplet.
* Each entry contains a collection of these language details.
*/
class CPropertyValuePair : public CBase
{
public:
    /**
    * Two-phase constructors.
    */
    static CPropertyValuePair* NewLC(TUid aPropertyId,
                                     const TDesC8& aValue);
    static CPropertyValuePair* NewLC(const CPropertyValuePair& aOther);
    static CPropertyValuePair* NewLC(RReadStream& aStream);

    /**
    * Destructor.
    */
    virtual ~CPropertyValuePair();

    // attribute getters
    /**
    * Returns the id of this property.
    */
    TUid PropertyId() const;

    /**
    * Returns the value of this property.
    */
    const TDesC8& Value() const;

    /**
    * Method used to (re-)set the value of this attribute.
    */
    void SetValueL(const TDesC8& aValue);

    // Streaming
    /**
    * Method used for serilazation of this object.
    * @param aStream Stream into which data is written to.
    */
    void ExternalizeL(RWriteStream& aStream) const;

    /**
    * Returns the number of bytes a buffer, used for streaming, must
    * at least consist of.
    * @return Number of bytes required by a buffer used for storing.
    */
    TInt SizeForStreamingL() const;

private:
    // 1st and 2nd phase constructors
    CPropertyValuePair(TUid aPropertyId = TUid());
    void ConstructL(const TDesC8& aValue);
    void ConstructL(RReadStream& aStream);

private:
    TUid iPropertyId;
    HBufC8* iValue;     // Owned.
};

#endif // PROPERTYVALUEPAIR_H