// 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 the License "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:

//

/**

 @internalComponent

*/

#ifndef APSICONCAPTIONOVERRIDE_H

#define APSICONCAPTIONOVERRIDE_H

#include <e32base.h>

#include <e32hashtab.h>

class CRepository;

class CApaIconCaptionOverrideStore;

/**

 * Read icon and caption details for an app according to the

 * language downgrade path, with ELangNone used as the default

 * language if no better match found.

 @see CApaIconCaptionOverrideStore

 */

NONSHARABLE_CLASS(TApaIconCaptionOverrideReader)

	{

public:

	TApaIconCaptionOverrideReader(const CApaIconCaptionOverrideStore& aStore, const RArray<TLanguage>& aLanguageDowngradePath);

	const TDesC* ShortCaption() const;

	const TDesC* Caption() const;

	TBool NumIconsSet() const;

	TInt NumIcons() const;

	const TDesC* IconFileName() const;

private:

	const TDesC* GetString(TUint32 aFieldId) const;

	const TInt* GetInt(TUint32 aFieldId) const;

private:

	const CApaIconCaptionOverrideStore& iStore;

	const RArray<TLanguage>& iLanguageDowngradePath;

	};

/**

* Stores the icon and caption overrides for an application.

*/

NONSHARABLE_CLASS(CApaIconCaptionOverridesForApp) : public CBase

	{

public:

	static CApaIconCaptionOverridesForApp* NewL();

	~CApaIconCaptionOverridesForApp();

	CApaIconCaptionOverridesForApp();

	void ConstructL();

	void LoadFromCenRepL(CRepository* aRepository, TUint32 aAppKey);

	TApaIconCaptionOverrideReader Reader(const RArray<TLanguage>& aLanguageDowngradePath) const;

private:

	CApaIconCaptionOverrideStore* iStore;

	};

/**

 * Store all of the icon and caption override data indexed by app UID

 */

NONSHARABLE_CLASS(CApaIconCaptionOverrides) : public CBase

	{

public:

	CApaIconCaptionOverrides();

	~CApaIconCaptionOverrides();

	void LoadFromCenRepL();

	void LoadFromCenRepL(CRepository* aRepository);

	CApaIconCaptionOverridesForApp* OverrideForApp(TUid aAppUid) const;

	void SetOverrideForAppL(TUid aAppUid, CApaIconCaptionOverridesForApp* aOverrides);	// takes ownership

private:

	void DeleteOverrides();

private:

	typedef RHashMap<TInt, CApaIconCaptionOverridesForApp*> RAppOverrideMap;

	RAppOverrideMap iMap;

	};

/**

* Watches for changes in the Central Repositiory and update the overrides when they occur.

*/

NONSHARABLE_CLASS(CApaIconCaptionCenrepObserver) : public CActive

	{

public:

	static CApaIconCaptionCenrepObserver* NewL(CApaIconCaptionOverrides& aOverrides);

	CApaIconCaptionCenrepObserver(CApaIconCaptionOverrides& aOverrides);

	~CApaIconCaptionCenrepObserver();

	void ConstructL();

	void LoadOverridesL();

private:

	void Start();

	void RunL();

	void DoCancel();

	TInt RunError(TInt aError);

private:

	CApaIconCaptionOverrides& iOverrides;

	CRepository* iRepository;	// owned

	};

#endif