// Copyright (c) 1997-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 __APGNOTIF_H__

#define __APGNOTIF_H__

#include <apgcli.h>

class MApaAppListServObserver

/**

MApaAppListServObserver is interface to get application list change notifications.

@publishedPartner

@released

*/

	{

public:

	enum TApaAppListEvent

		{

		EAppListChanged=1

		};

	virtual void HandleAppListEvent(TInt aEvent)=0;

protected:

	IMPORT_C MApaAppListServObserver();

private:

	IMPORT_C virtual void MApaAppListServObserver_Reserved1();

	IMPORT_C virtual void MApaAppListServObserver_Reserved2();

private:

	TInt iMApaAppListServObserver_Reserved1;

	};

class CApaAppListNotifier : public CActive

/** 

 * CApaAppListNotifier is an active object which notifies the client when an application list is changed.

 * Provides notification when applications are added, deleted or if the localisable data of an application

 * is modified.

 * 

 * Clients can create instance of this class using NewL function which takes MApaAppListServObserver

 * observer as one of the parameters. When application list is changed, CApaAppListNotifier will call 

 * HandleAppListEvent function of the provided observer. 

 * 

 * 

 * Example:

 * 

 * //Implementation of observer interface

 * class CAppListChangeObserver:public CBase, public MApaAppListServObserver

 * {

 * public:

 *     void HandleAppListEvent(TInt aEvent);    

 *     CApaAppListNotifier* iNotifier;    

 * };

 * 

 * //This function is called by CApaAppListNotifier when an application list is changed 

 * void CAppListChangeObserver::HandleAppListEvent(TInt aEvent)

 * {

 *     //Handle application list change event

 *     ...

 * }

 * 

 * 

 * TInt E32Main()

 * {

 * ....

 * 

 * CAppListChangeObserver* obs=new(ELeave) CAppListChangeObserver();

 * CApaAppListNotifier *notif=CApaAppListNotifier::NewL(obs, CActive::EPriorityStandard);

 * 

 * ....

 * }

 * 

 * 

@publishedPartner

@released */

	{

public:

	IMPORT_C ~CApaAppListNotifier();

	IMPORT_C static CApaAppListNotifier* NewL(MApaAppListServObserver* aObserver, TPriority aPriority);

private: // from CActive

	void DoCancel();

	void RunL();

    TInt RunError(TInt aError);	

private:

	CApaAppListNotifier(MApaAppListServObserver& aObserver, TPriority aPriority);

	void ConstructL();

private:

	MApaAppListServObserver& iObserver;

	RApaLsSession iLsSession;

	};

#endif