/*
* 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 __MENUENGOBJECTATTR_H__
#define __MENUENGOBJECTATTR_H__

#include <e32base.h>

/**
* Menu Engine Object attribute.
*/
NONSHARABLE_CLASS( CMenuEngObjectAttr ): public CBase
    {

public:     // construction

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

    /**
    * Two-phased constructor.
    * @param aName Name.
    * @return The created object.
    */
    static CMenuEngObjectAttr* NewL( const TDesC& aName );

    /**
    * Two-phased constructor.
    * @param aName Name.
    * @return The created object.
    */
    static CMenuEngObjectAttr* NewLC( const TDesC& aName );

protected:  // construction

    /**
     * Constructor
     */
    CMenuEngObjectAttr();
    
    /**
     * 2nd phase constructor.
     * @param aName Name.
     */
    void ConstructL( const TDesC& aName );

public:     // new methods

    /**
    * Get name.
    * @return Name.
    */
    TPtrC Name() const { return iName; }

    /**
    * Get value.
    * @return Value.
    */
    TPtrC Value() const { return iValue; }

    /**
    * Set (or replace) value.
    * @param aValue Value.
    */
    void SetValueL( const TDesC& aValue );

    /**
    * Get localized status.
    * @return ETrue if localized.
    */
    TBool Localized() const { return iLocalized; }

    /**
    * Set localized status.
    * @param aLocalized ETrue if localized.
    */
    void SetLocalized( TBool aLocalized ) { iLocalized = aLocalized; }

private:    // data
    
    RBuf iName; ///< Name. Own.
    RBuf iValue; ///< Value. Own.
    TBool iLocalized; ///< Localized status.

    };

/**
* Array of CMenuEngObjectAttr-s.
*/
NONSHARABLE_CLASS( RMenuEngObjectAttrArray )
: public RPointerArray<CMenuEngObjectAttr>
    {

public:     // new methods

    /**
    * Find attribute by name.
    * @param aName Name.
    * @return Index of attribute, or KErrNotFound.
    */
    TInt Find( const TDesC& aName ) const;

    };

#endif // __MENU_ENG_OBJECT_ATTR_H__