/*

* Copyright (c) 2008-2008 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:  Header file of central repository database property class

*

*/

#ifndef C_CENREPDATABASEPROPERTY_H

#define C_CENREPDATABASEPROPERTY_H

#include <e32base.h>

/**

 *  central repository property class

 *

 *  This class represent one property in central repository

 *

 *  @lib cenrepdatabase.lib

 *  @since S60 V3.2

 */

NONSHARABLE_CLASS( CCenRepDatabaseProperty ): public CBase

    {

	public: // Constructor and destructor

	    /**

	    * Two-phased constructor.

	    */

	    IMPORT_C static CCenRepDatabaseProperty* NewL();

	    /**

	    * Two-phased constructor.

	    */

	    IMPORT_C static CCenRepDatabaseProperty* NewLC();

	    /**

	    * Destructors.

	    */

	    IMPORT_C virtual ~CCenRepDatabaseProperty();

	public: // member functions

	    /**

	     * Returns the name of this property

	     *

	     * @since S60 V3.2

	     * @return Name of property

	     */

	    IMPORT_C TUint32 GetName() const;

	    /**

	     * Sets the name for this property

	     *

	     * @since S60 V3.2

	     * @param aPropertyname new property name

	     */

	    IMPORT_C void SetName( TUint32 aPropertyname );

	    /**

	     * Returns value of property

	     *

	     * @since S60 V3.2

	     * @param aValue on return, TInt value

	     * @return Error code

	     */

	    IMPORT_C TInt GetValue( TInt& aValue ) const;

	    /**

	     * Sets value of property. Value must match to datatype.

	     *

	     * @since S60 V3.2

	     * @param aValue new TInt value to be set

	     * @return Error code

	     */

	    IMPORT_C TInt SetValue( TInt aValue );

	    /**

	     * Returns value of property

	     *

	     * @since S60 V3.2

	     * @param aValue on return, descriptor value

	     * @return Error code

	     */

	    IMPORT_C const TDesC& GetDesValue() const;

	    /**

	     * Sets the value of property. Value must match to datatype.

	     *

	     * @since S60 V3.2

	     * @param aValue new descriptor

	     * @return Error code

	     */

	    IMPORT_C TInt SetValue( const TDesC& aValue );

	    /**

	     * Compares data of this property to another.

	     *

	     * @since S60 V3.2

	     * @param aProperty property to be compared

	     * @return ETrue if properties have same data

	     */

	    IMPORT_C TBool CCenRepDatabaseProperty::operator==( 

	                const CCenRepDatabaseProperty& aProperty ) const;

	private:

	    /**

	    * C++ default constructor.

	    */

	    CCenRepDatabaseProperty();

	    /**

	    * By default Symbian 2nd phase constructor is private.

	    */

	    void ConstructL();

	private: // data

	    /**

	     * Descriptor of property value

	     * Own.

	     */

	    RBuf iPropertyValue;

	    /**

	     * Name of property

	     */

	    TUint32 iPropertyName;

    private: // For testing

        #ifdef TEST_EUNIT

            friend class UT_CCenRepDatabaseProperty;

        #endif

    };

typedef RPointerArray<CCenRepDatabaseProperty> RIpAppPropArray;    

typedef RArray<TUint32> RKeyArray;

const TInt KCenRepMaxDesLength = 512;

#endif // C_CENREPDATABASEPROPERTY_H