/*

* Copyright (c) 2002 - 2006 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: 

*     This class is an extension to the standard Eikon label.

*     It provides leave-safe SetText() and is able to

*     clear its background before drawing.

*

*/

#ifndef __CVRLABEL_H__

#define __CVRLABEL_H__

// INCLUDES

#include <eiklabel.h>

#include <AknUtils.h>

// FORWARD DECLARATIONS

class MAknsSkinInstance;

// CLASS DEFINITION

/**

* This class is an extension to the standard Eikon label.

* It provides leave-safe SetText() and is able to

* clear its background before drawing.

*/

NONSHARABLE_CLASS( CVRLabel )

	: public CEikLabel

	{

	public: // Constructors and destructor

		/**

		* Two-phased constructor

		* @param aContainer Reference to the owning CCoeControl

		*/

		static CVRLabel* NewLC( const CCoeControl& aContainer );

		/**

		* Destructor.

		*/

		~CVRLabel();

	private: // Constructors

		/**

		* Default constructor.

		*/

		inline CVRLabel() {};

		/**

		* 2nd phase constructor.

		* @param aContainer Reference to the owning CCoeControl

		*/

		void ConstructL( const CCoeControl& aContainer );

	private: // from CCoeControl

		/**

		* Draws this label.

		* @param aRect The area that needs updating.

		*/

		void Draw( const TRect& aRect ) const;

	public: // New methods

		/**

		* Sets the text in this label.

		* Leave-safe. Panics if aText is too long.

		* @param aText The new contents.

		*/

		void SetText( const TDesC& aText );

		/**

		* Sets the text in this label.

		* Will draw the label if the given text

		* is different from the current one.

		* Leave-safe. Panics if aText is too long.

		* @param aText The new contents.

		*/

		void SetTextAndDraw( const TDesC& aText );

	private:

		// Skin instance. Not owned.

		MAknsSkinInstance* iSkin;

		TAknLayoutText iTextLayout;

	};

#endif	// __CVRLABEL_H__